Apache 模块 mod_example_hooks

可用语言: en | fr | ko

描述	演示 Apache 模块 API
状态	实验性
模块标识符	example_hooks_module
源文件	mod_example_hooks.c

摘要

Apache 分发目录树下的 modules/examples 目录中的文件是为希望编写使用 Apache API 的模块的人提供的示例。

主要文件是 mod_example_hooks.c，它演示了所有不同的回调机制和调用语法。附加模块绝不需要包含所有回调的例程 - 恰恰相反！

示例模块是一个实际工作的模块。如果您将其链接到您的服务器，为某个位置启用 "example-hooks-handler" 处理程序，然后浏览到该位置，您将看到示例模块在进行各种回调时所做的一些跟踪的显示。

指令

示例

错误修复清单

另请参阅

编译 example_hooks 模块

要将 example_hooks 模块包含在您的服务器中，请按照以下步骤操作

使用 --enable-example-hooks 选项运行 configure。
制作服务器（运行 "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. 从 modules/examples/config.m4 中复制带有 "example_hooks" 的 APACHE_MODULE 行。
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
语法	`示例`
上下文	服务器配置、虚拟主机、目录、.htaccess
状态	实验性
模块	mod_example_hooks

Example 指令只是设置一个演示标志，示例模块的内容处理程序会显示该标志。它不接受任何参数。如果您浏览到示例钩子内容处理程序适用的 URL，您将看到模块内的例程以及它们如何以及按什么顺序被调用以服务文档请求的显示。此指令的效果可以在 "Example directive declared here: YES/NO" 处观察到。