[转载] Apache模块开发/用C语言扩展apache(3：一个非常简单的apache module)

santaclaus

　　有了上面几篇文章的基础，大家自己再下点功夫，应该可以去写一些简单的模块了，下面贴出一个很简单的apache module，大家一起分析一下。


$ cd /usr/local/apache2.2.4
$ vi mod_c.c
 

#include
#include
#include “apr.h”
#include “apr_lib.h”
#include “apr_strings.h”
#define APR_WANT_STRFUNC
#include “apr_want.h”
#include “httpd.h”
#include “http_config.h”
#include “http_core.h”
#include “http_request.h”
module AP_MODULE_DECLARE_DATA c_module;
static int c_handler(request_rec *r)
{
r->content_type=”text/plain”;
ap_rprintf(r,”handler:%s\n”,r->handler);
ap_rprintf(r,”query string:%s\n”,r->args);
ap_rprintf(r,”filename:%s\n”,r->filename);
return OK;
}
static void register_hooks(apr_pool_t *p)
{
ap_hook_handler(c_handler, NULL, NULL, APR_HOOK_MIDDLE);
}

module AP_MODULE_DECLARE_DATA c_module = {
STANDARD20_MODULE_STUFF,
NULL,      
NULL,                       
NULL,      
NULL,                       
NULL,      
register_hooks   
};
 　　编译并安装这个模块(apache提供的apxs非常好)：

$ ./bin/apxs -c ./mod_c.c
$ ./bin/apxs -a -i -n c mod_c.la
 　　这时apxs会自动帮我们把编译好的mod_c.so安装到modules/目录中，而且httpd.conf中已经把这个module load进去了：

[iyunv@cn-weblog apache2.2.4]# grep mod_c conf/httpd.conf     
LoadModule c_module           modules/mod_c.so
 　　测试这个模块：

$ ./bin/apachectl stop
$ ./bin/apachectl start
 　　在IE中访问http://myhostname/index.html?query=yy
　　IE中会出现：
　　handler:text/html
　　query string:query=yy
　　filename:/usr/local/apache2.2.4/htdocs/index.html
　　说明该module运行成功。
　　把上面的module简单解释一下。
　　所有的apache module都必须是这个结构体，里面要定义各个内容。

module AP_MODULE_DECLARE_DATA c_module = {
STANDARD20_MODULE_STUFF,
NULL,      
NULL,                       
NULL,      
NULL,                       
//上面4项都是定义httpd.conf中命令的作用的
NULL,       //定义在httpd.conf中添加的命令，和各命令的处理函数
register_hooks          //hooks,定义什么时候执行我们这个module的相关函数
};
 　　ap_hook_handler(c_handler, NULL, NULL, APR_HOOK_MIDDLE);
　　表示在处理内容请求时调用我们函数–c_handler
　　同样的状态还有
　　OK : 成功请求
　　DECLINED ：忽略 
　　HTTP_METHOD_NOT_ALLOWED ：错误处理 
　　http://httpd.apache.org/docs/2.2/developer/
　　提供了非常不错的文档，可以参考一下。