Изучите Apache mod_rewrite: 13 реальных примеров

mod_rewrite Флаги

mod_rewrite использует «флаги», чтобы предоставить нашим условиям перезаписи и правилам дополнительные функции. Мы добавляем флаги в конце условия или правила, используя квадратные скобки, и разделяем несколько флагов запятой. Основные флаги, с которыми вам необходимо ознакомиться:

• last|L — флаг Last указывает Apache прекратить серию условий перезаписи и правила перезаписи таким же образом, как } завершит блок операторов в PHP. Обратите внимание, что этот флаг не прекращает обработку mod_rewrite!
• nocase|NC — Флаг No Case указывает Apache игнорировать регистр строки в регулярном выражении и часто необходим при написании оператора RewriteCond который соответствует переменной {HTTP_HOST} для доменного имени, которое не {HTTP_HOST} регистр.
• redirect|R — Флаг Redirect используется для запуска внешнего (видимого) перенаправления. По умолчанию это означает, что Apache выдаст ответ HTTP 302, чтобы указать, что документ был временно перемещен, но вы можете указать код HTTP, если хотите. Например, вы можете использовать [R=301] чтобы заставить Apache выдавать ответ HTTP 301 (постоянно перемещенный), что часто бывает полезно, если вам нужны поисковые системы для переиндексации измененного URI.
• qsappend|QSA — Флаг Query String Appended используется для «прохождения» через существующие строки запроса. Вы также можете определить новую строку запроса, к которой будет добавлена ​​старая строка, но будьте осторожны, чтобы не дублировать имена ключей. Отказ от использования флага QSA приведет к созданию строки запроса во время перенаправления, чтобы уничтожить существующую строку запроса.
• forbidden|F — флаг «Запрещено» используется для указания Apache, когда не следует предоставлять страницу в ответ на запрос. В результате Apache выдаст ответ HTTP 403, который можно использовать для защиты файлов от просмотра неавторизованными посетителями, пиявок пропускной способности и так далее.
• ornext|OR — Флаг OR позволяет вам комбинировать условия перезаписи с логическим отношением OR в противоположность стандартному AND.
• next|N — флаг Next указывает mod_rewrite перезапустить процесс перезаписи из первого правила, но использовать URI, возвращенный из последнего обработанного правила перезаписи. Это полезно для замены символов в {REQUEST_URI} когда вы не знаете, сколько их будет.

Вы можете прочитать о других доступных флагах на странице документации Apache.org mod_rewrite .

Комментарии к mod_rewrite

Оператор RewriteEngine on необходим в начале любого кода mod_rewrite, но он также полезен в другой роли. Как хороший программист, вы знаете, как важны комментарии в вашем коде. mod_rewrite позволяет закомментировать весь блок кода mod_rewrite, обернув код в RewriteEngine off и RewriteEngine on операторах:

 RewriteEngine off  RewriteCond %{HTTP_HOST} !^www.example.com$ [NC]  RewriteRule .? http://www.example.com%{REQUEST_URI} [R=301,L]  RewriteEngine on 

Ни одно из приведенных выше утверждений не будет прочитано модулем mod_rewrite. Операторы RewriteEngine могут быть очень полезны при разработке нового кода mod_rewrite — просто используйте их как оболочку /* ... */ для комментариев PHP.

mod_rewrite Советы

Как веб-мастер, вы должны определить, как ваши страницы будут идентифицироваться для посетителей, а также как переписать эти URI, чтобы Apache мог обслуживать соответствующий контент. Не забудьте внимательно рассмотреть создание новой схемы URI. И не забывайте, что после реализации вашей новой схемы URI вам, возможно, придется вернуться к старому контенту, обновив существующие ссылки, чтобы соответствовать новой схеме.

Когда вы разрабатываете свою новую схему URI, используйте уникальные ключи, когда можете. В предыдущем примере я использовал страны, штаты и города в качестве ключей — элементов, которые будут уникальными в базе данных. Но так как я создаю веб-сайты для клиентов, чтобы обновлять себя, для меня нецелесообразно настаивать на том, чтобы они предоставляли уникальные названия для всех своих статей. Статьи в базе данных обычно идентифицируются автоматически увеличивающимся идентификатором, который идеально подходит для моей дружественной схемы URI. Это значительно упрощает правила перезаписи, поскольку вы можете напрямую сопоставить атом URI со значением строки запроса.

Люди часто пытаются использовать базу данных для перенаправления из заголовка или другого подобного поля к определенному значению идентификатора. Для этой цели у mod_rewrite есть оператор RewriteMap , но у вас должен быть доступ к основному файлу конфигурации Apache: httpd.conf . Как правило, вы будете иметь доступ к этому файлу только в том случае, если вы владеете и управляете сервером. Вместо этого полностью избегайте проблемы и используйте поле ID для создания своих ссылок.

Помните, что пробелы обозначаются как %20 в URI, поэтому вам необходимо заменить их в своем коде PHP. Функция PHP str_replace идеально подходит для этой задачи. Как правило, нам нужно заменить пробелы на %20 при генерации ссылок и преобразовать %20 обратно в пробелы при чтении значений строки запроса из массива $_GET . Однако при работе с уникальными значениями полей базы данных, которые содержат пробелы, я предпочитаю использовать символ подчеркивания для замены пробелов в результирующих ссылках. Для этого вы можете использовать следующий код PHP:

 $name = str_replace ( ' ', '_', $name ); 

Будьте осторожны, чтобы не сломать существующие относительные ссылки при реализации новой схемы URI. Разработчики часто удивляются, когда внезапно перестают работать их CSS, файлы JavaScript и изображения. Помните, что относительные ссылки относятся к текущему URI на стороне браузера — это запрошенный URI, а не переписанный. В зависимости от конфигурации вашего сайта вам может потребоваться использовать абсолютные URI или <base> HTML <base> для всех ваших статических ресурсов.

13 примеров mod_rewrite

Ранее мы рассмотрели пример, который принудительно включал часть www доменного имени для каждого запроса. Давайте посмотрим еще на несколько примеров и посмотрим, насколько полезным может быть mod_rewrite.

1. Принудительное использование www для домена при сохранении поддоменов.

 RewriteCond %{HTTP_HOST} ^([az.]+)?example.com$ [NC]  RewriteCond %{HTTP_HOST} !^www. [NC]  RewriteRule .? http://www.%1example.com%{REQUEST_URI} [R=301,L] 

Это правило захватывает необязательный поддомен, используя переменную %1 , и, если оно не начинается с www., Перенаправляет с www. добавлен в поддомен. Домен и оригинал {REQUEST_URI} добавляются к результату.

2. Исключение www из домена

 RewriteCond %{HTTP_HOST} !^example.com$ [NC]  RewriteRule .? http://example.com%{REQUEST_URI} [R=301,L] 

3. Избавляемся от www, но сохраняем поддомен

 RewriteCond %{HTTP_HOST} ^www.(([a-z0-9_]+.)?example.com)$ [NC]  RewriteRule .? http://%1%{REQUEST_URI} [R=301,L] 

 RewriteCond %{HTTP_REFERER} !^$  RewriteCond %{HTTP_REFERER} !^http://(www.)?example.com/ [NC]  RewriteRule .(gif|jpg|png)$ - [F] 

 RewriteCond %{HTTP_REFERER} !^$  RewriteCond %{HTTP_REFERER} !^http://(www.)?example.com/.*$ [NC]  RewriteRule .(gif|jpg|png)$ http://www.example.com/hotlinked.gif [R=301,L] 

 RewriteCond %{HTTP_REFERER} !^http://(www.)?leech_site.com/ [NC]  RewriteRule .(gif|jpg|png)$ - [F,L] 

 RewriteCond %{REQUEST_FILENAME} !-f  RewriteCond %{REQUEST_FILENAME} !-d  RewriteRule .? /404.php [L] 

 RewriteRule ^/?(.*)$ /404.php?url=$1 [L] 

 RewriteRule ^/?old_directory/([az/.]+)$ new_directory/$1 [R=301,L] 

 RewriteRule ^/?([az/]+).html$ $1.php [L] 

 RewriteRule ^/?([az]+)$ $1.php [L] 

 RewriteCond %{REQUEST_FILENAME}.php -f  RewriteRule ^/?([a-zA-Z0-9]+)$ $1.php [L]  RewriteCond %{REQUEST_FILENAME}.html -f  RewriteRule ^/?([a-zA-Z0-9]+)$ $1.html [L] 

 RewriteCond %{QUERY_STRING} !uniquekey=  RewriteRule ^/?script_that_requires_uniquekey.php$ other_script.php [QSA,L] 

 RewriteCond %{QUERY_STRING} !marker  RewriteCond %{QUERY_STRING} id=([-a-zA-Z0-9_+]+)  RewriteRule ^/?index.php$ %1? [R=301,L]   RewriteRule ^/?([-a-zA-Z0-9_+]+)$ index.php?marker&id=$1 [L] 

 RewriteCond %{REQUEST_URI} ^secure_page.php$  RewriteCond %{HTTPS} !on  RewriteRule ^/?(secure_page.php)$ https://www.example.com/$1 [R=301,L] 

 RewriteCond %{REQUEST_URI} ^secure_page.php$  RewriteCond %{SERVER_PORT} !^443$  RewriteRule ^/?(secure_page.php)$ https://www.example.com/$1 [R=301,L] 

 RewriteCond %{SERVER_PORT} !^443$  RewriteRule ^/?(page1|page2|page3|page4|page5)$  https://www.example.com/%1 [R=301,L] 

 RewriteCond %{ SERVER_PORT } ^443$  RewriteRule !^/?(page6|page7|page8|page9)$ http://www.example.com%{REQUEST_URI} [R=301,L]