apache 模块编写
http://blog.csdn.net/hqin6/archive/2011/01/27/6166750.aspx
路径为:/home/xxx/
工具为:apxs
框架搭建:
1、准备工作:安装apache对应的httpd-devel,主要是为了安装apxs。
2、生成一个apache的模块框架:cd /home/xxx/; apache module:apxs -g -n mytest
这里的mytest就是apache模块的名字,但是实际生成的so名为:mod_mytest.so
3、编译apache模块:使用c++语言编写apache模块,网上有说使用extern"C"的方法(见 http://hi.baidu.com/zhangsilly/blog/item/a43fa11f869f4efae1fe0bf3.html),但是没有实验成功。extern"C"会有警告,而且编译不过~!
最后,将我的所有后台处理程序做成了一个liblogic.so,然后apache的模块mytest加载这个liblogic.so,而 apache模块mytest中只是接收请求,传递参数给liblogic.so进行处理!而在mytest的模块编译时,使用apxs的参数-S进行 CC重命名,如下:
apxs -c -a -S CC=g++ -I./src -I./src/common/ -llogic -L./src/ mod_mytest.c -Wl,-rpath=/home/xxx/mytest/src/
这里需要注意,即使你的mod_mytest.c中使用c++语言来编写,但是这个文件不能使用mod_mytest.cpp来进行命名,必须使用.c的后缀,否则不能编译!具体原因不明,待查!在使用-Wl,-rpath的时候,应用程序对实际的动态库路径寻找,需要注意!
可以通过/usr/lib64/apr-1/build/libtool --silent --mode=link g++ ...... 这里的silent去掉,看到具体的编译命令,前面有-Wl,--rpath -Wl,...可以看看!~
编译链接成功以后,在.libs/下会生成我们所用的mod_mytest.so
4、修改httpd.conf,添加:
LoadModule mytest_module /home/xxx/mytest/.libs/mod_mytest.so
<Location /index>
SetHandler mytest
</Location>
这里的index,表示index所对应的请求,比如:http://www.baidu.com/index?a=1&b=2 --- 这里的index将会使用module mytest去处理@!
重启apache即可!
上面讲了整个apache模块的搭建工作,以及编译和链接的命令和步骤,下面讲讲关于apache模块的开发:
apache模块的开发
经常会看的一个头文件:/usr/include/httpd/httpd.h
我们需要从哪儿入手:
打开mod_mytest.c文件,找到:static int mytest_handler(request_rec *r)这行!
这个函数就是我们需要修改的函数!
这里需要指出,对于所有的请求信息,都在这个r参数里!
第一个问题:取得url中的参数
http://www.baidu.com/index?a=1&b=2
比如,要取得上面的a/b两个参数,如何搞?
答案在r->args里,如上的url,r->args="a=1&b=2",我们所要做的事情是从这个串里取得a=1/b=2
下面是我写的一个函数,用来得到参数的,仅供参考!
view plaincopy to clipboardprint?
1. char* get_args_param(request_rec* r, const char* name)
2. {/*{{{*/
3. const char* args = r->args;
4. const char* start_args;
5. if (NULL != args)
6. {
7. for (start_args = ap_strstr_c(args, name); start_args;
8. start_args = ap_strstr_c(start_args + 1, name))
9. {
10. if (start_args == args || start_args[-1] == '&' || isspace(start_args[-1]))
11. {
12. start_args += strlen(name);
13. while (*start_args && isspace(*start_args))
14. ++start_args;
15. if (*start_args == '=' && start_args[1])
16. {
17. char* end_args;
18. char* arg;
19. ++start_args;
20. arg = apr_pstrdup(r->pool, start_args);
21. if ((end_args = strchr(arg, '&')) != NULL)
22. *end_args = '\0';
23. return arg;
24. }
25. }
26. }
27. }
28. return NULL;
29. }/*}}}*/
char* get_args_param(request_rec* r, const char* name) {/*{{{*/ const char* args = r->args; const char* start_args; if (NULL != args) { for (start_args = ap_strstr_c(args, name); start_args; start_args = ap_strstr_c(start_args + 1, name)) { if (start_args == args || start_args[-1] == '&' || isspace(start_args[-1])) { start_args += strlen(name); while (*start_args && isspace(*start_args)) ++start_args; if (*start_args == '=' && start_args[1]) { char* end_args; char* arg; ++start_args; arg = apr_pstrdup(r->pool, start_args); if ((end_args = strchr(arg, '&')) != NULL) *end_args = '\0'; return arg; } } } } return NULL; }/*}}}*/
这里借鉴了源码中的get_cookie_param的编写!下面会提到!
这里需要注意,对于apr_pstrdup函数的调用,需要包含头文件:#include "apr_strings.h",否则会有警告,并且在运行的时候会core掉!
这里的apr_pstrdup所分配的内存,不需要显式free,它是基于apr_pool_t,当request end后,一次性释放!
第二个问题:如何得到特定的cookie
这里需要用到r->headers_in,这是一个apr_table_t类型的hashmap!下面会详细说下。
因为cookie是类似于:abc=ui230jklsiu;def=uiore0832jhh1;这样的
这里就要使用到我上面所说的apache中proxy模块的源码:
apache-2.2.11-src/modules/proxy/mod_proxy_balancer.c中有get_cookie_param函数!
去看吧,google吧!
view plaincopy to clipboardprint?
1. char *get_cookie_param(request_rec *r, const char *name)
2. {/*{{{*/
3. const char *cookies;
4. const char *start_cookie;
5. if ((cookies = apr_table_get(r->headers_in, "Cookie"))) {
6. for (start_cookie = ap_strstr_c(cookies, name); start_cookie;
7. start_cookie = ap_strstr_c(start_cookie + 1, name)) {
8. if (start_cookie == cookies ||
9. start_cookie[-1] == ';' ||
10. start_cookie[-1] == ',' ||
11. isspace(start_cookie[-1])) {
12. start_cookie += strlen(name);
13. while(*start_cookie && isspace(*start_cookie))
14. ++start_cookie;
15. if (*start_cookie == '=' && start_cookie[1]) {
16. char *end_cookie, *cookie;
17. ++start_cookie;
18. cookie = apr_pstrdup(r->pool, start_cookie);
19. if ((end_cookie = strchr(cookie, ';')) != NULL)
20. *end_cookie = '\0';
21. if((end_cookie = strchr(cookie, ',')) != NULL)
22. *end_cookie = '\0';
23. return cookie;
24. }
25. }
26. }
27. }
28. return NULL;
29. }/*}}}*/
char *get_cookie_param(request_rec *r, const char *name) {/*{{{*/ const char *cookies; const char *start_cookie; if ((cookies = apr_table_get(r->headers_in, "Cookie"))) { for (start_cookie = ap_strstr_c(cookies, name); start_cookie; start_cookie = ap_strstr_c(start_cookie + 1, name)) { if (start_cookie == cookies || start_cookie[-1] == ';' || start_cookie[-1] == ',' || isspace(start_cookie[-1])) { start_cookie += strlen(name); while(*start_cookie && isspace(*start_cookie)) ++start_cookie; if (*start_cookie == '=' && start_cookie[1]) { char *end_cookie, *cookie; ++start_cookie; cookie = apr_pstrdup(r->pool, start_cookie); if ((end_cookie = strchr(cookie, ';')) != NULL) *end_cookie = '\0'; if((end_cookie = strchr(cookie, ',')) != NULL) *end_cookie = '\0'; return cookie; } } } } return NULL; }/*}}}*/
还有很多其他参数,比如User-Agent,Referer,Accept-Charset,Keep-Alive等很多头信息都在这个headers_in里,下面的这个网址可以找到你想要的:
http://en.wikipedia.org/wiki/List_of_HTTP_header_fields
比如,取到User-Agent:apr_table_get(r->headers_in, "User-Agent");
第三个问题:如何取得ip
r->connection->remote_ip
不多说了!
第四个问题:如何输出:
apache 提供了很多的输出函数,都是使用ap_打头的,在/usr/include/httpd/http_protocol.h中可以看到。下面摘录几个:
AP_DECLARE(int) ap_rputc(int c, request_rec *r);
AP_DECLARE(int) ap_rputs(const char *str, request_rec *r);
AP_DECLARE(int) ap_rwrite(const void *buf, int nbyte, request_rec *r);
AP_DECLARE_NONSTD(int) ap_rvputs(request_rec *r,...);
AP_DECLARE(int) ap_vrprintf(request_rec *r, const char *fmt, va_list vlist);
……
需要注意,对于ap_rputs,str不可为NULL,否则会引起core!
参考:
还有更多的说明,可以参考头文件:/usr/include/httpd/httpd.h
或者下面的网址对你有帮助:
对apache的一些常见问题说明:http://blog.sina.com.cn/s/blog_5bf18faf0100aph8.html
一个helloworld的例子:http://andrew913.iteye.com/blog/398648
reqeust_rec的结构说明:http://hi.baidu.com/start_and_end/blog/item/f344224ecadcc9c1d0c86a79.html
server_rec的结构说明:http://book.51cto.com/art/200805/72067.htm
apxs工具简介:http://lamp.linux.gov.cn/Apache/ApacheMenu/programs/apxs.html
关于filter模块的一个实例:http://www.cnblogs.com/ithurricane/archive/2009/01/01/1366312.html