Apache模块开发
二、安装
Apache HTTP服务器是一个模块化的软件,使管理者可以选择核心中包含的模块以裁剪功能。可以在编译时选择被静态包含进httpd二进制映象的模块,也可以编译成独立于主httpd二进制映象的动态共享对象DSO,DSO模块可以在编译服务器之后编译,也可以用Apache扩展工具(apxs)编译并增加。
1.官网下载源码包
#wget http://apache.fayea.com/httpd/httpd-2.4.25.tar.gz
2.yum安装apache
#yum install httpd
#yum install httpd-devel
2.随系统自启动
#chkconfig httpd on
3.开启apache
#service httpd start
4.检查是否安装成功
#rpm -qa|grep httpd
PS:在CentOS里Apache的默认文档路径的位置是在/var/www/html,配置文件的路径是/etc/httpd/conf/httpd.conf。其他的配置存储在/etc/httpd/conf.d/ 文件夹里。
三、apache中apxs扩展工具使用
apxs是一个为Apache超文本传输协议(HTTP)服务器编译安装扩展模块的工具, 用于编译一个或多个源程序或目标代码文件为动态共享对象, 使之可以用mod_so中的LoadModule指令 在运行时刻加载到Apache服务器中。
因此,要使用这个扩展机制,你的平台必须支持DSO(动态模块)特性, 而且Apache的httpd必须内建了mod_so模块。 apxs工具能自动探测是否具备这样的条件,你也可以自己用这个命令手动探测
#httpd -l
core.c
mod_so.c
http_core.c
注:mod_so包括LoadFile指令和LoadModule指令
概要:
apxs -g [ -S name=value ] -n modname
apxs -q [ -S name=value ] query ...
apxs -c [ -S name=value ] [ -o dsofile ] [ -I incdir ] [ -D name=value ] [ -L libdir ] [ -l libname ] [ -Wc,compiler-flags ] [ -Wl,linker-flags ] files ..
apxs -i [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ...
apxs -e [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ...
选项
一般选项
-n modname
它明确设置了-i(install)和-g (template generation)选项的模块名称。 对-g选项,它是必须的; 对-i选项,apxs工具会按文件名判断至少是推测出这个模块名称。
查询选项
-q
查询某种apxs设置的信息。 query参数可以是下列一个或多个字串:CC, CFLAGS, CFLAGS_SHLIB, INCLUDEDIR, LD_SHLIB, LDFLAGS_SHLIB, LIBEXECDIR, LIBS_SHLIB, SBINDIR, SYSCONFDIR, TARGET.
这个参数用于手动查询某些设置。比如,要手动处理Apache的C头文件,可以在Makefile中使用
INC=-I`apxs -q INCLUDEDIR`
配置选项
-S name=value
此选项可以改变apxs的上述设置。
模板生成选项
-g
此选项生成一个名为name的子目录(见选项-n)和其中的两个文件: 一个是名为mod_name.c的样板模块源程序, 可以用作建立你自己的模块的模板,或是学习使用apxs机制的良好开端; 另一个则是对应的Makefile,用于编译和安装此模块。
DSO编译选项
-c
此选项表示需要执行编译操作。 它首先会编译C源程序(.c)files为对应的目标代码文件(.o), 然后,连接这些目标代码和files中其余的目标代码文件(.o and .a), 以生成动态共享对象dsofile。如果没有指定-o选项, 则此输出文件名由files中的第一个文件名推测得到, 所以,缺省时,它一般会是mod_name.so.
-o dsofile
明确指定所建立的动态共享对象的文件名。 如果没有明确指定,而且也不能从files文件列表中推测得到, 则其文件名将为mod_unknown.so。
-D name=value
此选项定义直接提交给编译器的,以增加用于编译的变量。
-I incdir
此选项定义直接提交给编译器的变量,以增加用于编译的你自己的头文件目录。
-L libdir
此选项定义直接提交给编译器的变量,以增加用于编译的你自己的库文件目录。
-l libname
此选项定义直接提交给编译器的变量,以增加用于编译的你自己的库文件。
-Wc,compiler-flags
此选项用于附加编译参数compiler-flags到编译命令中,以增加编译器特有的参数。
-Wl,linker-flags
此选项用于附加连接参数linker-flags到连接命令中,以增加连接器特有的参数。
DSO的安装和配置选项
-i
此选项表示需要执行安装操作, 以安装一个或多个动态共享对象到服务器的modules目录中。
-a
此选项自动在httpd.conf文件中增加一个LoadModule行,以激活此模块,或者,如果此行已经存在,则启用之。
-A
与-a选项类似,但是它增加的LoadModule指令由一个井号前缀(#), 即,此模块已经准备就绪,但尚处于禁用状态。
-e
此选项表示需要执行编辑操作,它可以与-a和-A选项配合使用, 与-i操作类似,修改Apache的httpd.conf配置文件,但是并不安装此模块。
四、具体开发步骤:
1.利用Apache自带都apxs建立hello模块:
#apxs -g -n hello
这样就会在当前目录下新建一个hello模块的文件目录,可以看到里面有:Makefile mod_hello.c modules.mk这样的文件。
Creating [DIR] hello
Creating [FILE] hello/Makefile
Creating [FILE] hello/modules.mk
Creating [FILE] hello/mod_hello.c
Creating [FILE] hello/.deps
2.预览下mod_hello.c,可以看到里面apxs自动帮你生成一堆代码了,我们需要的只是修改里面的代码部分,先简单都介绍下里面的函数说明。
include 部分就是引入了一些必要都头文件
hello_handler 这个就是hello模块都主体部分,所有的显示、处理请求什么的都在这里。
hello_register_hooks,hello_module 这俩个是需要导出的函数所必须的,先可以不管他们,按照生成的不动即可。
3.修改hello_handler函数,里面可以看到request_rec *r,r有很多函数和变量,具体要参见文档了。里面的ap_rputs是输出,可以简单的理解为把字符串输出到r。
static int hello_handler(request_rec *r)
{
if (strcmp(r->handler, "hello")) { // 判断apache配置文件里handler是否等于hello,不是就跳过
return DECLINED;
}
r->content_type = "text/html"; // 设置content-type
if (!r->header_only)
ap_rputs("The sample page from mod_hello.c\n", r); // 输出一段文字
return OK; // 返回 200 OK状态
}
增加#include "mysq.h",查询需要用到这个头文件。
4.编译模块
#apxs -c -a -i -L/usr/lib64/mysql/ -lmysqlclient mod_hello.c
可以看到一堆编译指令,加上-I和-l是编译mysql必须的,编译完会自动在httpd.conf加上 LoadModule hello_module modules/mod_hello.so
5.修改httpd.conf
LoadModule hello_module modules/mod_hello.so #编译完会自动在httpd.conf加上
<Location /hello> #中间有空格
SetHandler hello
</Location >
6.重启apache,访问http://localhost/hello,看是否成功。
数据库systeminfo
数据库:test
表:systeminfo
CREATE TABLE `systeminfo` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`ip_info` varchar(50) NOT NULL,
`serv_info` varchar(50) NOT NULL,
`cpu_info` varchar(50) NOT NULL,
`disk_info` varchar(50) NOT NULL,
`mem_info` varchar(50) NOT NULL,
`load_info` varchar(50) NOT NULL,
`mark_info` varchar(50) NOT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `ip_info` (`ip_info`),
UNIQUE KEY `ip_info_2` (`ip_info`)
);
systeminfo
代码:
#include "httpd.h"
#include "http_config.h"
#include "http_protocol.h"
#include "ap_config.h"
/* 头文件,本文用到了ap_rprintf函数 */
#include "apr.h"
#include "apr_lib.h"
#include "apr_strings.h"
#include "apr_want.h"
#include "/usr/include/mysql/mysql.h"
/* 定义mysql数据变量 */
const char *host = "localhost";
const char *user = "root";
const char *pass = "root";
const char *db = "test";
/* The sample content handler */
static int hello_handler(request_rec *r)
{
if (strcmp(r->handler, "hello")) {
return DECLINED;
}
r->content_type = "text/html";
/* 定义mysql变量 */
MYSQL mysql;
MYSQL_RES *rs;
MYSQL_ROW row;
mysql_init(&mysql); /* 初始化 */
if (!mysql_real_connect(&mysql, host, user, pass, db, 0, NULL, 0)) {/* 连接数据库 */
ap_rprintf(r, "<li>Error : %d %s</li>\n", mysql_errno(&mysql), mysql_error(&mysql));
return OK;
}
char *sql = "select ip_info,mark_info from systeminfo order by rand()";
if (mysql_query(&mysql, sql)!=0) { /* 查询 */
ap_rprintf(r, "<li>Error : %d %s</li>\n", mysql_errno(&mysql), mysql_error(&mysql));
return OK;
}
rs = mysql_store_result(&mysql); /* 获取查询结果 */
while ((row = mysql_fetch_row(rs))) { /* 获取每一行记录 */
ap_rprintf(r, "<li>%s - %s</li>\n", row[0], row[1]);
}
mysql_free_result(rs); /* 释放结果集 */
mysql_close(&mysql); /* 关闭连接 */
return OK;
}
static void hello_register_hooks(apr_pool_t *p)
{
ap_hook_handler(hello_handler, NULL, NULL, APR_HOOK_MIDDLE);
}
/* Dispatch list for API hooks */
module AP_MODULE_DECLARE_DATA hello_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 */
hello_register_hooks /* register hooks */
};
mod_hello.c