По вопросам преобразования ссылок просьба обращаться к&nb p;Apache

Примеры (во всех случаях показано содержимое файла .htaccess, расположенного в корневом каталоге веб-сайта):

# Пример 1. Каталоги проектов project1 и project2 веб-сайта www.site.com ранее содержали статические html-страницы, теперь же эти страницы расположены на двух отдельных веб-сайтах project1.ru и project2.ru (в той же иерархии)

# Первый способ требует наличия модуля mod_proxy и создает дополнительную нагрузку на веб-сервер, но зато посетитель веб-сайта не знает, откуда в действительности выбираются веб-страницы

# Символы / даются с вопросительными знаками, чтобы правильно обработать ссылки вида /redir.php?url=www.site.com%2Fproject1 и /redir.php?url=www.site.com%2Fproject1%2F%3Cbr%3E
RewriteRule ^project1/?(.*) /redir.php?url=project1.ru%2F%241 [P]
RewriteRule ^project2/?(.*) /redir.php?url=project2.ru%2F%241 [P]

# Второй способ возвращает внешние редиректы, так что посетитель увидит в адресной строке своего браузера, что страницы реально расположены на других веб-сайтах

RewriteRule ^project1/?(.*) /redir.php?url=project1.ru%2F%241 [R]
RewriteRule ^project2/?(.*) /redir.php?url=project2.ru%2F%241 [R]

# Допустим, что в редиректах мы желаем передать в запросе какие-нибудь дополнительные параметры. Применение флага QSA позволит нам сохранить параметры оригинального запроса, так что ссылка /redir.php?url=site.com%2Fproject1%2Fnews.pl%3Fmode%3Ddaily будет преобразована в /redir.php?url=project1.ru%2Fnews.pl%3Fcame_from%3Dsite.com%26mode%3Ddaily%3Cbr%3E
RewriteRule ^project1/?(.*) /redir.php?url=project1.ru%2F%241%3Fcame_from%3Dsite.com [R,QSA]
RewriteRule ^project2/?(.*) /redir.php?url=project2.ru%2F%241%3Fcame_from%3Dsite.com [R,QSA]

# Пример 2. Электронная книга отдается динамическим скриптом в то время как нам желательно иметь «красивую» иерархию вида "/redir.php?url=lib.ru%2Fbook1%2Fchapter3.html". Кстати, расширение .html помогает нам скрывать динамическую природу нашего веб-сайта

RewriteRule ^([a-z0-9]+)/([a-z0-9]+)\.html$ /cgi-bin/view_chapter.cgi?book=$1&chapter=$2 [NC]

# Пример 3. Нам желательно скрыть от пользователя используемую на веб-сайте технологию, для чего мы не будем пользоваться расширениями в наших http-ссылках. Без флага L данное правило зациклится

RewriteRule (.+) $1.html [L]

# В то же время посетитель может ввести ссылку с расширением по одному ему понятным причинам. Правильно обработать такую ситуацию поможет следующее правило:

RewriteRule ^([^.]+) $1.html [L]

# Пример 4. На веб-сайте есть статические ссылки с расширением .html и динамические ссылки с расширением .pl. Допустим, что динамические ссылки остались прежними, а статические должны обрабатываться cgi-скриптом

# Первый вариант предельно прост:

RewriteRule (.+)\.html$ /cgi-bin/new_script.cgi?page=$1 [L]

# Второй вариант более общий. Например, если нам нужно преобразовать массу различных ссылок кроме одной-двух, можно воспользоваться специальной «заменой без изменения» (обозначается символом -):

RewriteRule \.pl$ — [L]
RewriteRule (.*) /cgi-bin/new_script.cgi?page=$1 [L]

# Пример 5. Есть один особый случай, когда делается внешний редирект на относительную ссылку. Допустим, мы находимся в каталоге /home/site.com/www/test веб-сайта site.com. Каталог доступен по ссылке /redir.php?url=site.com%2Ftest%2F. Нам нужен внешний редирект с файлов *.html на *.shtml. Приводимые директивы записываются в файл /home/site.com/www/test/.htaccess

# Решение тривиально, если использовать абсолютную замену, но в этом случае нам приходится жестко прописывать название каталога, что не совсем хорошо:

RewriteRule (.+)\.html /test/$1.shtml [R]

# Если написать замену как относительную ссылку (см. ниже), то результат будет не таким, каким мы его ожидаем увидеть (это обусловлено особенностями преобразования ссылок на уровне каталогов): например, ссылка /redir.php?url=site.com%2Ftest%2Faaa.html будет преобразована в /redir.php?url=site.com%2Fhome%2Fsite.com%2Fwww%2Ftest%2Faaa.shtml%3Cbr%3E
RewriteRule (.+)\.html $1.shtml [R]

# По полученной ссылке видно, что там подставлен полный реальный путь к нужному файлу. Решить проблему можно при помощи директивы RewriteBase, параметром которой является префикс для всех относительных замен, находящихся в данном файле .htaccess

RewriteBase /test

# Пример 6. Задание переменных окружения применяется очень редко, но тем не менее приведем два примера, не нуждающихся в пояснении

# Сохраняет в окружении расширение исходного файла

RewriteRule ^([^.]+)\.([a-z]+)$ /cgi-bin/new_script.cgi?page=$1 [L,E=EXT:$2]

# Сохраняет в окружении содержимое http-заголовка X-Forwarded-For

RewriteRule \.(cgi|pl)$ — [L,E=%{HTTP:X-Forwarded-For}]

Директивы RewriteCond предназначены для проверки некоторых дополнительных параметровНесмотря на такое изобилие, преобразование ссылок не ограничивается только директивой RewriteRule. Есть еще одна директива, которая используется не менее часто — это директива RewriteCond. Данная директива предназначена для проверки некоторых дополнительных параметров и всегда ставится непосредственно перед директивой RewriteRule. Если директива RewriteCond «срабатывает», то проверяется следующая за ней директива RewriteRule, если же «не срабатывает», то директива RewriteRule игнорируется.

# Если подряд записаны несколько директив RewriteCond, то следующая за ними директива RewriteRule проверяется только в том случае, когда «сработали» все директивы RewriteCond:

RewriteCond условие1
RewriteCond условие2
RewriteRule преобразование1

RewriteRule преобразование2

# Следует обратить внимание, что в приведенном выше примере вторая директива RewriteRule проверяется в любом случае, так как все директивы RewriteCond относятся только к первой директиве RewriteRule. Если же вы желаете, чтобы условия относились к обеим директивам RewriteRule, то вам придется повторить их еще раз:

RewriteCond условие1
RewriteCond условие2
RewriteRule преобразование1

RewriteCond условие1
RewriteCond условие2
RewriteRule преобразование2

# Применение флага OR позволяет объединять условия не по И (как это делается по умолчанию), а по ИЛИ. В следующем примере директива RewriteRule проверяется, если выполняется любое из двух предшествующих условий:

RewriteCond условие1 [OR]
RewriteCond условие2
RewriteRule преобразование

Синтаксис директивы RewriteCond выглядит следующим образом:

RewriteCond «проверяемое выражение» «условие» «флаги»

Проверяемое выражение — это строка, которая может состоять из обычных символов, макросов и переменных. Макросы $1, $2 и так далее ссылаются на соответствующие выражения в скобках из следующей по порядку директивы RewriteRule. Макросы %1, %2 и так далее ссылаются на выражения в скобках из предыдущей по порядку директивы RewriteCond. Кстати, макросы %* могут также использоваться и в директивах RewriteRule для ссылки на предыдущую директиву RewriteCond.

Переменные записываются в виде %{ИМЯ_ПЕРЕМЕННОЙ}. Наиболее часто используются следующие переменные: QUERY_STRING (параметры запроса), REMOTE_ADDR (IP-адрес^* посетителя), REMOTE_HOST (имя хоста посетителя), REMOTE_USER (имя пользователя, если он прошел авторизацию), REMOTE_METHOD (обычно GET или POST), PATH_INFO (путь к файлу веб-страницы), HTTP_USER_AGENT (содержимое http-заголовка User-Agent), HTTP_REFERER (содержимое http-заголовка Referer), HTTP_COOKIE (содержимое http-заголовка Cookie), HTTP_HOST (имя хоста веб-сайта), TIME_YEAR (все переменные TIME_* хранят разбитые на части текущие дату и время), TIME_MON, TIME_DAY, TIME_HOUR, TIME_MIN, TIME_SEC, TIME_WDAY, REQUEST_URI (строка запроса без имени хоста и параметров запроса), REQUEST_FILENAME (имя файла из REQUEST_URI), THE_REQUEST (полная строка запроса в том виде, в котором ее присылает браузер посетителя). Помимо стандартных переменных можно проверять содержимое любого http-заголовка: %{HTTP:Название-Заголовка}.

Условие — это обычное регулярное выражение. Кроме регулярных выражений существует еще несколько видов условий (условию может предшествовать символ !, который трактуется как отрицание):

• =ABC — значение переменной должно быть лексически равно строке ABC
• >ABC — значение переменной должно быть лексически больше строки ABC
• <ABC — значение переменной должно быть лексически меньше строки ABC
• -d — должен существовать каталог, имя которого совпадает со значением переменной
• -f — должен существовать файл, имя которого совпадает со значением переменной
• -s — должен существовать файл ненулевой длины, имя которого совпадает со значением переменной
• -l — должен существовать симлинк, имя которого совпадает со значением переменной
• -F — должен существовать файл, имя которого совпадает со значением переменной, и этот файл должен быть доступен по внешней ссылке на данный веб-сайт
• -U — должна быть доступна http-ссылка, имя которой совпадает со значением переменной

Флагов может быть всего два: OR (объединение директив RewriteCond по ИЛИ, как было написано выше) и NC (отключение проверки регистра аналогично одноименному флагу для директивы RewriteRule).

И, наконец, примеры применения:

# Пример 1. Жесткий запрет посещений нашего веб-сайта для робота поисковой системы Google

RewriteCond %{USER_AGENT} Googlebot
RewriteRule .* — [F]

# Другой вариант возвращает вместо ошибки 403 (FORBIDDEN) ошибку 404 (NOT_FOUND)

RewriteCond %{USER_AGENT} Googlebot
RewriteRule .* — [R=404]

# Пример 2. Есть два каталога /home/site/storage1 и /home/site/storage2, в которых нужно искать запрашиваемые файлы

RewriteCond /home/site/storage1/%{REQUEST_FILENAME} -f
RewriteRule (.+) /home/site/storage1/$1 [L]

RewriteCond /home/site/storage2/%{REQUEST_FILENAME} -f
RewriteRule (.+) /home/site/storage2/$1 [L]

# Пример 3. Если ссылка не найдена на нашем веб-сайте, отправить посетителя на www.site.ru

RewriteCond %{REQUEST_URI} !-U
RewriteRule (.*) /redir.php?url=www.site.ru%2F%241 [R]

# Пример 4. Закрыть доступ к веб-сайту в рабочее время

RewriteCond %{TIME_HOUR}%{TIME_MIN} >1000
RewriteCond %{TIME_HOUR}%{TIME_MIN} <1900
RewriteRule .* — [F]

# Пример 5. Есть скрипт, раз в сутки производящий оптимизацию базы данных. Если посетитель зайдет в этот момент на веб-сайт, то получит ошибку — вместо этого необходимо показать ему страницу с сообщением о том, что через пару минут все придет в норму. Оптимизирующий скрипт на время своей работы создает файл /home/site/optimizer.pid

RewriteCond /home/site/optimizer.pid -f
RewriteRule .* /optimization_message.html

# Пример 6. Посетители веб-сайта авторизуются при помощи стандартной авторизации (AuthType BasicAuth). Необходимо по ссылке /home/* показывать содержимое их домашних каталогов

RewriteCond %{REMOTE_USER} !=""
RewriteCond /home/(%{REMOTE_USER}) -d
RewriteRule (.*) /home/%1/$1

Для простейших преобразований можно пользоваться директивами Redirect и RedirectMatchИ в заключение вкратце упомянем еще о двух директивах преобразования ссылок, которые не входят в модуль mod_rewrite — это Redirect и RedirectMatch. Ими можно пользоваться, во-первых, как упрощенными вариантами директивы RewriteRule, а во-вторых, в случаях, когда модуль mod_rewrite по каким-то причинам отсутствует в вашей сборке веб-сервера Apache. Примеры:

# Обе директивы при «срабатывании» возвращают редиректы. В качестве замены всегда должна использоваться абсолютная ссылка

# Обычный безусловный редирект:

Redirect /news /redir.php?url=www.site.com%2Fcgi-bin%2Fnews.cgi%3Cbr%3E
# Редирект с подстановкой:

RedirectMatch (.*\.gif)$ /redir.php?url=www.site.com%2Falt%2Fpath%2Fto%2Fgif%2Ffiles%241%3C%2Fi%3E

Возможно, на первый взгляд преобразование http-ссылок с помощью модуля mod_rewrite покажется очень сложной задачей, но на самом деле это не так: с опытом придет и понимание, и мастерство. Если вы внимательно читаете документацию, четко представляете необходимые преобразования ссылок и тщательно проверяете написанные вами правила, все будет работать правильно. Иначе и быть не может, не так ли?

Ссылки по теме