Но как же сопоставить идентификатор обработчика тому сценарию, который содержит его код? У сервера Apache для этого есть специальная директива под названием Action. Где задается эта директива? В любом файле конфигурации Apache. Конечно, удобнее всего это делать в файле .htaccess, расположенном в корневом каталоге виртуального хоста, чтобы изменения распространились сразу на весь сервер. Мы уже рассматривали такую стратегию выше, только теперь все будет чуточку сложнее.

Вот требуемые директивы. Поместим их, как водится, в главный .htaccess-файл хоста.

# Сначала связ1ваем имя обработчика с конкретн1м файлом.

# Знак "?" говорит серверу, что исходн1Й URL запроса следует

# передать сценарию методом GET, т. е. через QUERY STRING. Action libhandler "/lib/libhandler.php?"

# Теперь уведомляем сервер, документы какого типа желаем

# " пропускать" через наш обработчик. AddHandler libhandler .html .htm

В этом фрагменте есть два тонких места.

□ Путь к сценарию обработчика всегда указывается как абсолютный URL без указания имени хоста и порта. Мы не можем задать здесь ни путь к файлу, ни даже относительный URL. По той причине, чтобы позволить одному обработчику "передавать эстафету" другому. В самом деле, ведь это и происходит в нашем примере: Apache сначала определяет, что документ нужно "пропустить" через обработчик libhandler, а т. к. он представляет собой ни что иное, как сценарий на PHP, то и через интерпретатор PHP. В деталях затронутый процесс чуть сложнее, но мы не будем в него углубляться.

□ После URL сценария в директиве Action следует знак ?. Зачем он? Это связано с механизмом, который использует Apache для того, чтобы определить конечный обработчик для того или иного документа. Когда пользователь посылает серверу URL, который, как Apache "знает", подходит под одну из команд Action, к этому URL слева просто присоединяется второй параметр директивы, и все начинается сначала - до тех пор, пока не будет найден последний обработчик. Например, если пользователь ввел /dir/file.html, то благодаря директиве Action указанный адрес преобразуется в /lib/libhandler.php?/dir/file.html. Это - ни что иное, как адрес PHP-сценария с параметром, который будет передан программе, как обгчно, через переменную окружения query string.

Теперь сервер знает, что все документы с расширением html и htm нужно обрабатывать при помощи сценария, расположенного по адресу /lib/libhandler.php. Точнее, при каждой попытке открыть страницы с указанными расширениями Apache будет запускать наш сценарий и в числе обычных переменных окружения отправлять ему несколько специальных, содержащих первичную информацию о запросе, переданном пользователем. Мы сейчас рассмотрим эти переменные на практике. Если вас интересует их полный список, попробуйте распечатать массив $globals или вос-

Вы, возможно, спросите, почему же мы не добавили в список расширений, на которые будет "реагировать" сценарий, еще одно - php? Давайте посмотрим, что бы произошло, поступи мы так. Предположим, пользователь хочет загрузить страницу /a.php. Apache "видит", что расширение у нее - php, и запускает обработчик с именем /lib/libhandler.php. Точнее, он "сваливает" всю работу на сценарий libhandler.php. Еще точнее - перенаправляет сервер по адресу /lib/libhandler.php?a.php! И тут же зацикливается, потому что у этого сценария расширение - также php. Итак, сервер начинает вызывать сценарий снова и снова, все удлиняя его URL - до тех пор, пока не "поймет": что-то неверно, и пора аварийно завершаться, о чем и сообщает в файлах журнала. О том, как решить эту проблему, рассказано в самом конце главы.

Ну вот, у нас уже почти все готово. Осталось только написать сам код обработчика. Это не так уж и сложно. Но прежде давайте вспомним, зачем мы вообще связались с обработчиками. Для автоматической загрузки библиотекаря перед выполнением того или иного сценария, помните? Что же, вот пример (листинг 29.5).

( Замечание

Мы подразумеваем, что обработчик libhandler.php находится в том же самом каталоге, что и библиотекарь с большинством модулей. Это довольно удобно, поскольку позволяет нам задавать путь к каталогу с модулями лишь в единственном месте - в директиве Action файла .htaccess, да и то в виде относительного URL. Оцените, насколько это проще для будущих модификаций сайта.

Листинг 29.5. Обработчик /lib/libhandler.php с подключением библиотекаря

<?

Прежде всего, устанавливаем свои каталоги поиска модулей.

Это, по нашей договоренности, - текущий в данн1й момент каталог.

$INC[]=getcwd();

Проверяем, не пытается ли пользователь запустить обработчик напрямую,

минуя Apache - например, путем набора в браузере адреса

/lib/libhandler.php. Так как адрес, введенн1й пользователем,

всегда передается в переменной окружения REQUEST URI, то нужно

"бить тревогу", если переданная строка адреса встречается

пользоваться функцией phpinfo(), вставив ее первой и единственной командой обработчика libhandler.php.

в имени файла обработчика ( причем в любом регистре символов). не заб1ли отрезать в этой строке часть после ?, потому что она будет мешать при сравнении с именем файла.

К сожалению, похоже, это единственный переносимый между операционными системами способ проверки легальности запуска обработчика. $FileName=strtr( FILE ,"\\","/");

$ReqName=ereg Replace("\\?.*","",strtr(getenv("REQUEST URI"),"\\","/")); if(eregi(quotemeta($ReqName),$FileName)) {

Выводим сообщение об ошибке

include "libhandler.err";

Записываем в журнал данные о пользователе

$f=fopen("libhandler.log","a+");

fputs($f,date("d.m.Y H:i.s")." $REMOTE ADDR - Access denied\n");

fclose($f);

Завершаем работу exit;

Все в порядке - корректируем переменные окружения в соответствии

с запрошенным пользователем адресом.

@putenv("REQUEST URI=".

$GLOBALS["HTTP ENV VARS"]["REQUEST URI"]=

$GLOBALS["REQUEST URI"]=

getenv("QUERY STRING")

@putenv("QUERY STRING=".

$GLOBALS["HTTP ENV VARS"]["QUERY STRING"]= $GLOBALS["QUERY STRING"]=

ereg Replace("[?]*\\?","",getenv("QUERY STRING"))

Подключаем библиотекарь include "librarian.phl";

Здесь можно выполнить еще какие-нибудь действия...

. . .

Запускаем тот сценарий, который был запрошен пользователем

chdir(dirname($SCRIPT FILENAME));

include $SCRIPT FILENAME;

?>