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，就可以看到我们返回的内容)
运行结果如下图：