Apache: Модуль Apache mod_example

RU EN

Пункт 139. Модуль Apache mod_example_hooks

Файлы в modules/examples каталоге дерева каталогов дистрибутива Apache предоставляются в качестве примера тем, кто хочет писать модули, использующие API Apache.

Основной файл — mod_example_hooks.c , который иллюстрирует все различные механизмы обратного вызова и синтаксис вызова. Ни в коем случае дополнительный модуль не должен включать подпрограммы для всех обратных вызовов — как раз наоборот!

Модуль-пример — это реально работающий модуль. Если вы свяжете его со своим сервером, включите обработчик «example-hooks-handler» для местоположения, а затем перейдите к этому местоположению, вы увидите отображение части трассировки, выполненной модулем-примером при выполнении различных обратных вызовов.

Компиляция модуля example_hooks

Чтобы включить модуль example_hooks на свой сервер, выполните следующие действия:

Запуск configure с --enable-example-hooks опцией.
Сделать сервер (запустить " make ").

Чтобы добавить еще один собственный модуль:

cp modules/examples/mod_example_hooks.c modules/new_module/mod_myexample.c
Измените файл.
Создать modules/new_module/config.m4 .
1. Добавить APACHE_MODPATH_INIT(new_module) .
2. Скопируйте строку APACHE_MODULE с «example_hooks» из modules/examples/config.m4 .
3. Замените первый аргумент «example_hooks» на myexample .
4. Замените второй аргумент кратким описанием вашего модуля. Он будет использоваться в configure --help .
5. Если вашему модулю нужны дополнительные флаги компилятора C, флаги компоновщика или библиотеки, добавьте их в CFLAGS, LDFLAGS и LIBS соответственно. config.m4 Примеры смотрите в других файлах в каталоге модулей.
6. Добавить APACHE_MODPATH_FINISH .
Создать module/new_module/Makefile.in . Если вашему модулю не нужны специальные инструкции по сборке, все, что вам нужно в этом файле, это include $(top_srcdir)/build/special.mk .
Запустите ./buildconf из каталога верхнего уровня.
Создайте сервер с --enable-myexample

Использование `mod_example_hooks` модуля

Чтобы активировать модуль example_hooks, включите в свой файл блок, подобный следующему apache2.conf :

 <Расположение "/example-hooks-info">
 SetHandler пример обработчика хуков
</местоположение>

В качестве альтернативы вы можете поместить в файл следующее .htaccess , а затем запросить файл «test.example» из этого места:

 AddHandler пример-хуков-обработчик ".example"

После перезагрузки/перезапуска сервера вы сможете перейти к этому местоположению и увидеть краткий экран, упомянутый ранее.

Пример директивы

Описание:	Демонстрационная директива для иллюстрации API модуля Apache
Синтаксис:	`Example`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Положение дел:	Экспериментальный
Модуль:	mod_example_hooks

Директива Example просто устанавливает демонстрационный флаг, который отображает обработчик содержимого модуля примера. Не требует аргументов. Если вы перейдете по URL-адресу, к которому применяется обработчик содержимого example-hooks, вы увидите подпрограммы в модуле, а также то, как и в каком порядке они вызывались для обслуживания запроса документа. Действие этой директивы можно наблюдать под пунктом " Example directive declared here: YES/NO ".

Компиляция модуля example_hooks

Использование mod_example_hooks модуля

Пример директивы

Использование `mod_example_hooks` модуля