Хокинс С. - Администрирование Web-сервера Apache и руководст

Глава

11

ПЕРЕНАЗНАЧЕНИЕ АДРЕСА

11.1. Введение

Модуль mod_rewrite позволяет перезаписывать полученные запросы на основа нии шаблонов переменных окружения и даже данных, выбранных из баз данных. Гибкость и мощь этого модуля потребовали включения его в стандартный дистрибу тив Apache, но он не загружается по умолчанию из за большого размера.

Чтобы загрузить модуль mod_rewrite, достаточно включить в конфигурационный файл следующие строки:

AddModulemod_rewrite.с

LoadModule rewrite_module libexec/mod_rewrite.so

Из за своей сложности модуль mod_rewrite заслуженно имеет дурную репутацию. Но при том, что он считается одним из самых сложных модулей Apache, по степени своей сложности он ушел недалеко от, скажем, программы sendmail или агрессивной неопределенности лицензий на коммерческое программное обеспечение. Вероятно, самым сложным этапом изучения поведения mod_rewrite является постижение пра вил чтения и записи регулярных выражений. Если вы знакомы с ними, то это не со ставит большого труда. Если нет — советую для краткого обучения обратиться к при ложению А, "Основные директивы".

Подсказка

Функциональность модуля mod_rewrite можно локализировать. С помощью стандартных ограничи телей, таких как Directory или VirtualHost,ее можно ограничить или задать в конфигурацион I ных файлах. Например в файле .htaccess.

11.2. Модуль mod_rewrite

Я думаю, что будет совершенно справедливо сказать о модуле mod_rewrite как о модуле, имеющем три составляющих. Об этом сейчас идет много споров, но мне представляется, что директивы, перечисленные в табл. 11.1, являются основными ди рективами модуля mod_rewrite.

Таблица 11.1. Основные директивы модуля mod_rewrite

11.2.1. Запуск модуля mod_rewrite: директива RewriteEngine

Директива RewriteEngine используется для включения и отключения режима пе резаписи URL. Для включения режима необходимо задать следующую директиву:

RewriteEngine on

11.2.2. Перезапись URL по шаблону: директива RewriteRule

Директива RewriteRule занимает в модуле mod_rewrite центральное место. Она име ет два параметра. Это регулярное выражение, которое является правилом, и новое значе ние. Сама по себе директива достаточно проста, но синтаксис параметров шаблона и за мещения довольно замысловат. Директива RewriteRule имеет следующий синтаксис:

RewriteRule pattern substitution [flag],

где параметр flagможет принимать одно из значений, указанных в табл. 11.2.

Таблица 11.2. Значения параметра flag директивы RewriteRule

Следующие три примера иллюстрируют различные способы проверки соответствия шаблону в порядке возрастания их сложности. Во всех примерах в качестве основного URL будем рассматривать www.examplel.com. Помните также, что для того, чтобы ди ректива RewriteRule работала эффективно, сначала необходимо директивой RewriteEngine активизировать модуль mod_rewrite.

Пример 11.1.

Для того, чтобы модуль mod_rewrite перезаписывал (фактически перемаршрутизировал) запросы вида

wvw.example1.com/obsolete

на ; www.example1.com/newandimproved,

необходима следующая директива:

RewriteRule A/obsolete.html/newandimproved.cgi

Пример 11.2.

Предположим, что возникла необходимость провести обслуживание файловой системы, имеющей DocumentRoot, не прерывая при этом работы сервера. Чтобы перенаправить весь трафик на узле в резервный каталог /apache_backup, задайте следующее правило:

RewriteRule ^/$ /apache backup [R]

Пример 11.3.

Предположим, что на узел поступают запросы с

www.examplel.com/~someguy

и их необходимо переписать в каноническом формате URL. Этот пример предполагает, что в файловой системе под каталогом DocumentRoot существует каталог /usr. Следующее правило RewriteRule ^~ ( [ ^ / l + ) / ? ( . * > /usr/$1/$2 [R]

: перепишет URL из приведенного выше формата в формат www.examplel.com/usr/someguy

11.2.3.Заданиепредварительного условия: директива RewriteCond

Сама по себе директива RewriteCond ничего не переписывает. Она используется в совокупности с директивой Rewrit eRule для определения предварительных условий, которые должны быть удовлетворены до того, как механизм попробует подобрать со ответствие шаблону, заданному директивой RewriteRule.

Многие переменные директивы RewriteCond могут составлять последовательно сти (логическое "И"). Если вам необходимо выполнить соответствующую директиву RewriteRule, когда одна директива RewriteCond или их последовательность прини мает значение "истина", воспользуйтесь флагом "OR".

Директива RewriteCond имеет следующий синтаксис: RewriteCond testvar condpattern flag,

где параметр testvar должен принимать одно из значений, перечисленных в табл. 11.3.

Существующий URL

Регулярное выражение

Компоненты регулярного выражения

Рис. 11.1. Декомпозиция регулярного выражения

Параметр condpattern задает шаблон, который используется в операциях сравнения с переменной testvar. В шаблоне может быть применен любой из перечисленных в табл. 11.4 префиксов.

Таблица 11.4. Синтаксис условного выражения

Выражение Действие

Кроме того, можно задать дополнительные флаги CondPattern:

Пример 11.4.

Пример директивы, проверяющей значение переменной SERVERPORT на значение 443.

RewriteCond S ERVERPORT =443

Пример 11.5.

Пример директив, которые проверяют значение переменной SERVERPORT на значение 443 или 80. Соответ ствующее значение RewriteRule будет проверено, если одно из условий возвращает значение "Истина".

RewriteCond SERVERPORT =443 OR

RewriteCond SERVERPORT =80

Пример 11.6.

Пример директив, которые проверяют значение переменной SERVERPORT на значение 443 и то, что переменная REMOTEHOST не равна badguy, Соответствующее значение RewriteRule будет про верено, только если одно или оба условия возвращают значение "Истина".

RewriteCond SERVERPORT =443

RewriteCond REMOTEHOST !badguy

11.3. Усовершенствованный модуль mod_rewrite

Дополнительно к своим основным возможностям модуль mod_rewrite имеет ряд достаточно мощных дополнительных возможностей. Одной из таковых является воз можность настройки модуля mod_rewrite для работы с текстовым файлом, базой данных или работающей программой. Таким образом можно получить информацию по перезаписи URL. Кроме того, модуль mod_rewrite имеет свои собственные воз можности регистрации (уровень RewriteLog и RewriteLogLevel). Можно задать уровень, до которого на виртуальный сервер влияет настройка родительского сервера (RewriteOptions). Наконец, можно задать основной URL для использования в пред полагаемых перезаписях (RewriteBase).

11.3.1. Упорядочение файлов: директива RewriteMap

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

RewriteMap MapName МарТуре:M apSource

Параметр MapName задает имя настройки для последующего использования в ди рективе RewriteRule.Параметр MapName будет использоваться в правиле перезаписи с использованием одной из следующих конструкций:

${MapName : LookupKey }

${MapName : LookupKey | DefaultValue}

При использовании этих правил значение LookupKey будет использоваться в на стройке, заданной в MapName.

Значения МарТуре и MapSource могут быть комбинацией:

•стандартного текста

•случайного текста

•хеш файла

•внутренней функции

•внешней программы перезаписи

Стандартный текст

Тип txt

Источник /path/to/map/file

Если МарТуре является текстовой строкой, значение источника должно указывать на текстовый файл, отформатированный как

longdata abbreviation,

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

##

## mapl.txt — rewriting map

##

Ralf.S.Engelschall rse Mr.Joe.Average joe

Пример 11.7.

Предположим, что файл настройки находится в /opt/apache/maps/map1.txt. Это означает, что директива должна задаваться следующим образом:

RewriteMap real—to—user txt: /opt/apache/maps/mapl.txt

Произвольный текстовый файл

"|" в качестве разделителя, а возвращается одно из составляющих (например www3). Это можно использовать в установках proxy для балансирования нагрузки.

Пример 11.8.

Предположим, что есть файл размещения в формате . txt. Он имеет следующий вид:

и хранится в каталоге /opt/apache/maps, В таком случае воспользуемся следующей директивой:

RewriteMap servers rnd:/opt/apache/maps/map2.txt

Хеш$файл

Тип dbm

Источник /path/to/unix/file

В этом случае исходным файлом является двоичный файл NDBM, который был создан из текстового файла (см. выше), но потом преобразован для более эффективного поиска.

Пример 11.9.

Допустим существует файл NDBM, размещенный в каталоге /opt/apache/maps/map3.ndbm. В этом случае к нему можно получить доступ с помощью строки

RewriteMap quick_servers dbm:/opt/apache/maps/mарЗ.ndbm

Внутренняя функция

Тип int

внутренняя функция сервера Apache

Здесь источником является внутренняя функция Apache. В настоящее время возможность создавать свои функции отсутствует, но можно воспользоваться уже существующими функциями, перечисленными в табл. 11.5.

Таблица 11.5. Функции

Пример 11.10.

Предположим, что возникла необходимость перевести все получаемые URL в нижний регистр. Это мож носделатьс помощьюфункции:

RewriteMap lease int:tolower

Внешняя программа перезаписи

Тип prg

Источник /path/to/executable/file

В таком виде источником является программа или сценарий. Будьте осторожны при создании таких программ. Их зависание вызывает зависание сервера Apache.

Пример 11.11.

Предположим, что требуется некая произвольная трансляция URL. Для этого был создан сценарий на языке Perl funky.pl и сохранен в каталоге /usr/bin. Его можно вызвать командой:

RewriteMap funky prg:/usr/bin/funky.pl

Пример 11.12.

Предположим, что нужно перераспределить нагрузку на сервер на основе достаточно произвольной ха рактеристики запрошенного пользователем URL Для этого создается простой текстовый файл распределения dist.txt, который будет ассоциировать адреса, начинающиеся с букв от "а" до "f" с одним сервером, ад реса, начинающиеся с букв от "д" до "I" с другим, и так далее. Файл распределения хранится в каталоге /etc. Директива RewriteMap применяется для того, чтобы информировать об этом сервер с помощью имени distributed следующим образом:

RewriteMap distributed txt:/etc/dist.txt

Затем получим доступ к заданному распределению с помощью директивы RewriteRule.

RewriteRule ^ / ( . ) { . * ) ${distributed:$1|www.default.com}$1 $2 [R,L]

Первый символ "." просматривает первый символ и сохраняет его в аргументе $1, Второй символ ".*" сим волизирует остаток оригинальной строки. Первый символ сравнивается с ключами, хранящимися в файле dis tributed, и возвращается имя нового сервера. В случае, если совпадение не обнаружено, использу ется сервер www.default.com. Наконец, первоначальная строка присоединяется в конец к новой строке.

11.3.2. Регистрация: директивы

RewriteLog, RewriteLogLevel

Модуль mod_rewrite может хранить информацию в журнале о производимых операциях. Имя и размещение журнала задает администратор. Чтобы включить такую

возможность, воспользуйтесь директивой RewriteLog, которая принимает в качестве параметра только путь к регистрационному журналу.

RewriteLog /var/logs/rewr itelog

Имеются различные уровни регистрации, начиная с 0 (регистрация не производит ся) до 9 (глубокая детализация). Установите уровень регистрации с помощью дирек тивы RewriteLogLevel.

RewriteLogLevel 3

11.3.3. Наследование: директива RewriteOptions

Директива RewriteOptions была задумана как многофункциональная конфигура ционная директива, но в данный момент единственным вариантом ее применения яв ляется задание возможности наследования от родителей конфигурационных свойств виртуальными узлами и каталогами (например, размещение или условия). Чтобы включить возможность наследования, необходимо задать директиву вида:

RewriteOptions inherit

11.3.4. Назначение основного каталога: директива RewriteBase

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

RewriteBase /some/other/path