C语言-apache mod(模块开发)-采用apxs开发实战(centos7.2 linux篇)

C语言-apache mod(模块开发)-采用apxs开发实战(centos7.2 linux篇)


名词解释：apxs
apxs is a tool for building and installing extension modules for the Apache HyperText Transfer Protocol (HTTP) server. 
apxs是用来编译和安装 apache 服务器的扩展模块(mod)、也能生成项目模版(下面有具体使用说明)
名词解释：MinGW
MinGW，是Minimalist GNUfor Windows的缩写。它是一个可自由使用和自由发布的Windows特定头文件和使用GNU工具集导入库的集合，
允许你在GNU/Linux和Windows平台生成本地的Windows程序而不需要第三方C运行时（C Runtime）库。
MinGW 是一组包含文件和端口库，其功能是允许控制台模式的程序使用微软的标准C运行时（C Runtime）库（MSVCRT.DLL）,该库在所有的 NT OS 上有效，
在所有的 Windows 95发行版以上的 Windows OS 有效，使用基本运行时，你可以使用 GCC 写控制台模式的符合美国标准化组织（ANSI）程序，
可以使用微软提供的 C 运行时（C Runtime）扩展，与基本运行时相结合，就可以有充分的权利既使用 CRT（C Runtime）又使用 WindowsAPI功能。


二、centos7.2 linux下开发 
0）(apache安装配置略)


1）安装 apxs
yum search apxs #查找apxs安装包，
yum install httpd-devel #apxs所在包，里面带的有apxs


2）建立一个开发目录
mkdir apachemod
进入apachemod目录
cd apachemod


3）用apxs建立一个mod模版
运行apxs -g -n helloworld(helloworld为模块名),会生成一个叫helloworld的目录和模板代码
模版代码如下：
=========================mod_helloworld.c===========================================
/* 
**  mod_helloworld.c -- Apache sample helloworld module
**  [Autogenerated via ``apxs -n helloworld -g'']
**
**  To play with this sample module first compile it into a
**  DSO file and install it into Apache's modules directory 
**  by running:
**
**    $ apxs -c -i mod_helloworld.c
**
**  Then activate it in Apache's httpd.conf file for instance
**  for the URL /helloworld in as follows:
**
**    #   httpd.conf
**    LoadModule helloworld_module modules/mod_helloworld.so
**    <Location /helloworld>
**    SetHandler helloworld
**    </Location>
**
**  Then after restarting Apache via
**
**    $ apachectl restart
**
**  you immediately can request the URL /helloworld and watch for the
**  output of this module. This can be achieved for instance via:
**
**    $ lynx -mime_header http://localhost/helloworld 
**
**  The output should be similar to the following one:
**
**    HTTP/1.1 200 OK
**    Date: Tue, 31 Mar 1998 14:42:22 GMT
**    Server: Apache/1.3.4 (Unix)
**    Connection: close
**    Content-Type: text/html
**  
**    The sample page from mod_helloworld.c
*/ 


#include "httpd.h"
#include "http_config.h"
#include "http_protocol.h"
#include "ap_config.h"


/* The sample content handler */
static int helloworld_handler(request_rec *r)
{
    if (strcmp(r->handler, "helloworld")) {
        return DECLINED;
    }
    r->content_type = "text/html";      


    if (!r->header_only)
        ap_rputs("小样，用C语言开发一个Apache的Module，这下牛逼了吧</br>在centos7.2上哦\n", r);
    return OK;
}


static void helloworld_register_hooks(apr_pool_t *p)
{
    ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE);
}


/* Dispatch list for API hooks */
module AP_MODULE_DECLARE_DATA helloworld_module = {
    STANDARD20_MODULE_STUFF, 
    NULL,                  /* create per-dir    config structures */
    NULL,                  /* merge  per-dir    config structures */
    NULL,                  /* create per-server config structures */
    NULL,                  /* merge  per-server config structures */
    NULL,                  /* table of config file commands       */
    helloworld_register_hooks  /* register hooks                      */
};
====================================================================================
4）编译并安装：
apxs -i -a -c mod_helloworld.c #运行之后生成的mod_helloworld.so
apxs生成之后会自动将
LoadModule helloworld_module  /usr/lib64/httpd/modules/mod_helloworld.so
这一行添加到apache.conf 文件中


centos终端编译效果如下图：


5）配置apache
我们要做的就是编辑 apache.conf
编辑命令：
vi /etc/httpd/conf/httpd.conf


找到 LoadModule helloworld_module  /usr/lib64/httpd/modules/mod_helloworld.so 这一行在下面加入


<Location /helloworld>
 setHandler helloworld
</Location>


:wq #进行保存


6）然后重启apache服务
service httpd restart
重启后查看一下咱们的服务状态：
serice httpd status
查看一下8080端口(我设置的是8080，你也可以按照你的实际来)
lsof -i:8080
出现：
# lsof -i:8080
COMMAND    PID   USER   FD   TYPE  DEVICE SIZE/OFF NODE NAME
httpd   142314   root    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142315 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142316 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142317 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142318 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142319 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
httpd   142320 apache    4u  IPv6 1580018      0t0  TCP *:webcache (LISTEN)
表示一切正常


7）在浏览器里面输入http://loacalhost/helloworld，就可以看到我们返回的内容)
运行结果如下图：


     大功告成


8）centos的代码和编译后的so 模块下载地址
http://download.csdn.net/detail/tengyunjiawu_com/9811657


9）参考资料：

http://httpd.apache.org/docs/2.2/programs/apxs.html