Apache: Использование обработчика Apache

RU EN

Пункт 22. Использование обработчика Apache

В этом документе описывается использование обработчиков Apache.

Что такое обработчик

Связанные модули	Связанные директивы
`mod_actions` `mod_asis` `mod_cgi` `mod_imagemap` `mod_info` `mod_mime` `mod_negotiation` `mod_status`	`Action` `AddHandler` `RemoveHandler` `SetHandler`

«Обработчик» — это внутреннее представление Apache действия, которое должно выполняться при вызове файла. Как правило, файлы имеют неявные обработчики, зависящие от типа файла. Обычно все файлы просто обслуживаются сервером, но некоторые типы файлов «обрабатываются» отдельно.

Обработчики также могут быть настроены явно, на основе расширений имен файлов или местоположения, независимо от типа файла. Это выгодно как потому, что это более элегантное решение, так и потому, что оно также позволяет связать с файлом как тип, так и обработчик. (См. также Файлы с несколькими расширениями.)

Обработчики могут быть либо встроены в сервер, либо включены в модуль, либо их можно добавить с помощью директивы Action . В стандартный дистрибутив встроены следующие обработчики:

default-handler : отправить файл с помощью default_handler() обработчика , используемого по умолчанию для обработки статического содержимого. (основной)
send-as-is : отправить файл с заголовками HTTP как есть. ( mod_asis )
cgi-script : обрабатывать файл как сценарий CGI. ( mod_cgi )
imap-file : анализировать как файл правил карты изображений. ( mod_imagemap )
server-info : получить информацию о конфигурации сервера. ( mod_info )
server-status : получить отчет о состоянии сервера. ( mod_status )
type-map : анализировать как файл карты типов для согласования содержимого. ( mod_negotiation )

Примеры

Изменение статического содержимого с помощью сценария CGI

Следующие директивы вызовут запросы файлов с html расширением для запуска footer.pl CGI-скрипта.

 Действие add-footer /cgi-bin/footer.pl
AddHandler добавить-нижний колонтитул .html

Затем сценарий CGI отвечает за отправку первоначально запрошенного документа (на который указывает PATH_TRANSLATED переменная среды) и внесение необходимых изменений или дополнений.

Файлы с заголовками HTTP

Следующие директивы включают send-as-is обработчик, который используется для файлов, содержащих собственные заголовки HTTP. Все файлы в /web/htdocs/asis/ каталоге будут обработаны обработчиком send-as-is , независимо от их расширений.

 <Каталог "/web/htdocs/asis">
 SetHandler отправить как есть
</Каталог>

Примечание программиста

Для реализации функций обработчика в API Apache было внесено дополнение, которым вы, возможно, захотите воспользоваться. В частности, в структуру добавлена новая запись request_rec :

 символ * обработчик

Если вы хотите, чтобы ваш модуль задействовал обработчик, вам нужно только установить r->handler имя обработчика в любое время до invoke_handler стадии запроса. Обработчики реализованы так же, как и раньше, хотя и с использованием имени обработчика вместо типа содержимого. Хотя в этом нет необходимости, соглашение об именовании обработчиков заключается в использовании слова, разделенного тире, без косой черты, чтобы не вторгаться в пространство имен типа носителя.