Apache模块mod_example_hooks

描述：	说明了Apache模块API
状态：	实验性
模块标识符：	example_hooks_module
源文件：	mod_example_hooks.c

摘要

modules/examplesApache分发目录树下目录中的文件作为示例提供给那些希望编写使用Apache API的模块的文件。

主文件是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. 从中复制带有“ example_hooks”的APACHE_MODULE行 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模块，请在httpd.conf文件中包含一个类似于以下内容的块：

<Location "/example-hooks-info">
   SetHandler example-hooks-handler
</Location>

或者，您可以将以下内容放入.htaccess文件中，然后从该位置请求文件“ test.example”：

AddHandler example-hooks-handler ".example"

重新加载/重新启动服务器后，您应该能够浏览到该位置并看到前面提到的简短显示。

指令 示例

描述：	演示指令来说明Apache模块API
句法：	`Example`
内容：	服务器配置，虚拟主机，目录，.htaccess
状态：	实验性
模块：	mod_example_hooks

该Example指令仅设置示例模块的内容处理程序显示的演示标志。它不带参数。如果浏览到示例摘录内容处理程序所应用的URL，则将显示该模块中的例程，以及如何以及以什么顺序调用它们来满足文档请求。该指令的效果可以在“ Example directive declared here: YES/NO” 点下观察到。

Apache模块mod_example_hooks

摘要

主题

指令

错误修正清单

也可以看看

编译example_hooks模块

使用mod_example_hooks模块

指令示例

注释

使用`mod_example_hooks`模块