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