apache添加扩展模块（不重新编译）

转自：http://blog.163.com/lgh_2002/blog/static/44017526201002454411471/

下面是使用apxs工具给apache添加模块

添加的模块：
LoadModule proxy_module       libexec/mod_proxy.so
LoadModule rewrite_module     libexec/mod_rewrite.so
LoadModule headers_module     libexec/mod_headers.so

添加方法：
1. 进入apache1.3.33 源文件modules目录
cd apache_1.3.33/src/modules/

2. 安装 proxy_module
> cd proxy
> /user/local/apache/bin/apxs -i -a -c *.c

3. 安装 rewrite_module
> cd standard
> /user/local/apache/bin/apxs -i -a -c mod_rewrite.c

4. 安装 headers_module
> cd standard
> /user/local/apache/bin/apxs -i -a -c mod_headers.c

但是，用这种方法添加的proxy不可用，提示错误：
/apache/httpd/bin/apachectl configtest
httpd: Syntax error on line 58 of /apache/httpd-2.2.3/conf/httpd.conf: Cannot load /apache/httpd-2.2.3/modules/mod_proxy.so into server: /apache/httpd-2.2.3/modules/mod_proxy.so: undefined symbol: proxy_lb_workers

所以，应该这样：

在Linux系统下，需要给已经运行的Apache增加mod_proxy模块，编译的时候应该这样：

apxs -c -i mod_proxy.c proxy_util.c

否则你可能会收到这样的错误信息

[root@server1 proxy]# /apache/httpd/bin/apachectl configtest
httpd: Syntax error on line 58 of /apache/httpd-2.2.3/conf/httpd.conf: Cannot load /apache/httpd-2.2.3/modules/mod_proxy.so into server: /apache/httpd-2.2.3/modules/mod_proxy.so: undefined symbol: proxy_lb_workers

如果你还加载了mod_proxy_ajp.so那应该

apxs -c -i mod_proxy_ajp.c ajp*.c
[root@server1 proxy]# /apache/httpd/bin/apachectl configtest
httpd: Syntax error on line 58 of /apache/httpd-2.2.3/conf/httpd.conf: Cannot load /apache/httpd-2.2.3/modules/mod_proxy_ajp.so into server: /apache/httpd-2.2.3/modules/mod_proxy_ajp.so: undefined symbol: ajp_msg_reset

这是为什么呢？请看

apxs - Apache 扩展工具

de<apxsde<是一个为Apache HTTP服务器编译和安装扩展模块的工具，用于编译一个或多个源程序或目标代码文件为动态共享对象，使之可以用由de<mod_sode<提供的de<LoadModulede<指令在运行时加载到Apache服务器中。

因此，要使用这个扩展机制，你的平台必须支持DSO特性，而且Apache de<httpdde<必须内建了de<mod_sode<模块。de<apxsde<工具能自动探测是否具备这样的条件，你也可以自己用这个命令手动探测：

de<$ httpd -l de<

该命令的输出列表中应该有de<mod_sode<模块。如果所有这些条件均已具备，则可以很容易地借助de<apxsde<安装你自己的DSO模块以扩展Apache服务器的功能：

de<$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /path/to/apache/modules/mod_foo.so
chmod 755 /path/to/apache/modules/mod_foo.so
[activating module 'foo' in /path/to/apache/etc/httpd.conf]
$ apachectl restart
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module
/path/to/apache/sbin/apachectl restart: httpd started
$ _ de<

其中的参数files可以是任何C源程序文件(.c)、目标代码文件(.o)、甚至是一个库(.a)。de<apxsde<工具会根据其后缀自动编译C源程序或者连接目标代码和库。但是，使用预编译的目标代码时，必须保证它们是地址独立代码(PIC)，使之能被动态地加载。如果使用GCC编译，则应该使用 de<-fpicde< 参数；如果使用其他C编译器，则应该查阅其手册，为de<apxsde<使用相应的编译参数。

有关Apache对DSO的支持的详细信息，可以阅读de<mod_sode<文档，或者直接阅读de<src/modules/standard/mod_so.cde<源程序。

语法

de<apxs -g [ -S name=value ] -n modnamede<

de<apxs -q [ -S name=value ] query ...de<

de<apxs -c [ -S name=value ] [ -o dsofile ] [ -I incdir ] [ -D name=value ] [ -L libdir ] [ -l libname ] [ -Wc,compiler-flags ] [ -Wl,linker-flags ] files ...de<

de<apxs -i [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ...de<

de<apxs -e [ -S name=value ] [ -n modname ] [ -a ] [ -A ] dso-file ...de<

选项

一般选项

de< -n modnamede<

它明确设置了 de< -ide<(安装)和 de< -gde<(模板生成)选项的模块名称。对 de< -gde< 选项，它是必须的；对 de< -ide< 选项，de< apxsde<工具会根据源代码判断，或(在失败的情况下)按文件名推测出这个模块的名称。

查询选项

de< -qde<

查询某种de< apxsde<设置的信息。该选项的 query参数可以是下列一个或多个字符串：de< CCde<, de< CFLAGSde<, de< CFLAGS_SHLIBde<, de< INCLUDEDIRde<, de< LD_SHLIBde<, de< LDFLAGS_SHLIBde<, de< LIBEXECDIRde<, de< LIBS_SHLIBde<, de< SBINDIRde<, de< SYSCONFDIRde<, de< TARGETde< 。

这个参数用于手动查询某些设置。比如，要手动处理Apache的C头文件，可以在Makefile中使用：

de<INC=-I`apxs -q INCLUDEDIR` de<

配置选项

de< -S name=valuede<

此选项可以改变apxs的上述设置。

模板生成选项

de< -gde<

此选项生成一个名为 name的子目录(见选项 de< -nde<)和其中的两个文件：一个是名为de< mod_name.cde<的样板模块源程序，可以用来建立你自己的模块，或是学习使用apxs机制的良好开端；另一个则是对应的de< Makefilede< ，用于编译和安装此模块。

DSO编译选项

de< -cde<

此选项表示需要执行编译操作。它首先会编译C源程序(.c) files为对应的目标代码文件(.o)，然后连接这些目标代码和 files中其余的目标代码文件(.o和.a)，以生成动态共享对象 dsofile 。如果没有指定 de< -ode< 选项，则此输出文件名由 files中的第一个文件名推测得到，也就是默认为de< mod_name.sode< 。

de< -o dsofilede<

明确指定所建立的动态共享对象的文件名，它不能从 files文件列表中推测得到。如果没有明确指定，则其文件名将为de< mod_unknown.sode< 。

de< -D name=valuede<

此选项直接传递到给编译命令，用于增加自定义的编译变量。

de< -I incdirde<

此选项直接传递到给编译命令，用于增加自定义的包含目录。

de< -L libdirde<

此选项直接传递到给连接命令，用于增加自定义的库文件目录。

de< -l libnamede<

此选项直接传递到给连接命令，用于增加自定义的库文件。

de< -Wc,compiler-flagsde<

此选项用于向编译命令 de< libtool --mode=compilede< 中附加 compiler-flags ，以增加编译器特有的选项。

de< -Wl,linker-flagsde<

此选项用于向连接命令 de< libtool --mode=linkde< 中附加 linker-flags ，以增加连接器特有的选项。

DSO的安装和配置选项

de< -ide<

此选项表示需要执行安装操作，以安装一个或多个动态共享对象到服务器的 modules目录中。

de< -ade<

此选项自动增加一个de< LoadModulede<行到de< httpd.confde<文件中，以激活此模块，或者，如果此行已经存在，则启用之。

de< -Ade<

与 de< -ade< 选项类似，但是它增加的de< LoadModulede<命令有一个井号前缀(de< #de<)，即此模块已经准备就绪但尚未启用。

de< -ede<

表示需要执行编辑操作，它可以与 de< -ade< 和 de< -Ade< 选项配合使用，与 de< -ide< 操作类似，修改Apache的de< httpd.confde<文件，但是并不安装此模块。

举例

假设有一个扩展Apache功能的模块de<mod_foo.cde< ，使用下列命令，可以将C源程序编译为共享模块，以在运行时加载到Apache服务器中：

de<$ apxs -c mod_foo.c
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$ _ de<

然后，必须修改Apache的配置，以确保有一个de<LoadModulede<指令来加载此共享对象。为了简化这一步骤，de<apxsde<可以自动进行该操作，以安装此共享对象到"modules"目录，并更新de<httpd.confde<文件，命令如下：

de<$ apxs -i -a mod_foo.la
/path/to/instdso.sh mod_foo.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules ... chmod 755 /path/to/apache/modules/mod_foo.so
[activating module 'foo' in /path/to/apache/conf/httpd.conf]
$ _ de<

如果配置文件中尚不存在，会增加下列的行：

de<LoadModule foo_module modules/mod_foo.so de<

如果你希望默认禁用此模块，可以使用 de<-Ade< 选项，即：

de<$ apxs -i -A mod_foo.c de<

要快速测试apxs机制，可以建立一个Apache模块样板及其对应的Makefile ：

de<$ apxs -g -n foo
Creating [DIR] foo
Creating [FILE] foo/Makefile
Creating [FILE] foo/modules.mk
Creating [FILE] foo/mod_foo.c
Creating [FILE] foo/.deps
$ _ de<

然后，立即可以编译此样板模块为共享对象并加载到Apache服务器中：

de<$ cd foo
$ make all reload
apxs -c mod_foo.c
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/path/to/instdso.sh mod_foo.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules ... chmod 755 /path/to/apache/modules/mod_foo.so
[activating module 'foo' in /path/to/apache/conf/httpd.conf]
apachectl restart
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module
/path/to/apache/sbin/apachectl restart: httpd started

de<