Apache 模块开发主要采用挂钩子的方法来实现模块开发的,这和linux内核模块开发有点像,说白了就是加一个回调函数。下面我们来讲 这个例子吧。
首先来介绍下apache的一个工具apxs。apxs是一个为Apache HTTP服务器编译和安装扩展模块的工具,用于编译一个或多个源程序或目标代码文件为动态共享对象,使之可以用由mod_so提供的LoadModule指令在运行时加载到Apache服务器中。
1.apxs -g -n helloworld
上面的命令可以帮助我们产生一个模块名字为helloworld的模板。
上面的命令会产生以下代码
1. #include "httpd.h"
2. #include "http_config.h"
3. #include "http_protocol.h"
4. #include "ap_config.h"
5.
6. /* The sample content handler */
7. static int
8. {
9. if (strcmp(r->handler, "helloworld")) {
10. return
11. }
12. "text/html";
13.
14. if
15. "The sample page from mod_helloworld.c\n", r);
16. return
17. }
18.
19. static void
20. {
21. ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE);
22. }
23. /* Dispatch list for API hooks */
24. module AP_MODULE_DECLARE_DATA helloworld_module = {
25. //用于编译后的模块产生版本信息
26. /* 创建目录配置结构*/
27. /* 合并目录配置结构 */
28. /* 创建主机配置结构 */
29. /* 合并主机配置结构 */
30. /* 为模块配置相关指令 */
31. /* 注册模块的钩子函数 */
32. };
我们来看下helloworld_module这个结构体,它没个成员的具体作用请看注释。
它最关键的参数为最后一个,这个参数是一个注册钩子函数指针,也就是说当我们把模块加入到apache里面去的时候,他会执行这个注册函数。在这个函数里面我们将会注册我们所要添加的钩子。
本例子中我们用的是
1. ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE);
这个处理函数,这个处理函数注册了helloworld_handler这个函数。这个函数用于处理我们的请求。
我们来讲下执行的顺序,模块加载-》执行helloworld_register_hooks函数-》注册helloworld_handler这个函数到钩子上去。
这样一来:当一个http请求来的时候,我们就会自动去执行helloworld_handler这个函数。本例子是一个非常简单的内容生成器。
1. if (strcmp(r->handler, "helloworld")) {//判断是否是这个helloworld handler
2. return DECLINED;//
3. }
4. "text/html";
5. if
6. "The sample page from mod_helloworld.c\n", r);//内容生成
7. return
下面我们将来进行编译
执行:apxs -c mod_helloworld.c
执行成功以后我们可以发现在.libs下面会出现mod_helloworld.so这个模块文件。这就是我们所需要的,对于apache一些自带的模块一般都放在安装目录的modules/下面。
下面我们来对其进行配置
打开httpd.conf文件,添加以下信息
1. LoadModule helloworld_module *****// 指定.so文件的路径。
2.
3. <Location /helloworld>
4. setHandler helloworld
5. </Location>
Ok ,重启apache 然后输入 http://loacalhost/helloworld 就可以看到
The sample page from mod_helloworld.c
当然这里这里只是输出一句话,我们也可以打印很多html信息,就类似于servlet一样。
这样一来一个简单的apache内容生成器模块已经开发好了,当然应用比较广泛的是过滤器模块的开发,最近项目主要也是用过滤器来实现的。
apache 可以开发出一些功能非常强大的模块来,可以为我们定制更好的apache,比如容器中应用的流量统计,cpu统计等。