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终端编译效果如下图:
![](//img-blog.csdn.net/20170412140633863)
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,就可以看到我们返回的内容)
运行结果如下图:
![](//img-blog.csdn.net/20170412140639597)
大功告成
8)centos的代码和编译后的so 模块下载地址
http://download.csdn.net/detail/tengyunjiawu_com/9811657
9)参考资料:
名词解释: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
小白救星 QQ 99923309