转自: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 扩展工具
因此,要使用这个扩展机制,你的平台必须支持DSO特性,而且Apache
该命令的输出列表中应该有
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
$ _
其中的参数files可以是任何C源程序文件(.c)、目标代码文件(.o)、甚至是一个库(.a)。
有关Apache对DSO的支持的详细信息,可以阅读
语法
选项
一般选项
-
它明确设置了
de< -i de<(安装)和 de< -g de<(模板生成)选项的模块名称。对 de< -g de< 选项,它是必须的;对 de< -i de< 选项, de< apxs de<工具会根据源代码判断,或(在失败的情况下)按文件名推测出这个模块的名称。
查询选项
-
查询某种
de< apxs de<设置的信息。该选项的 query参数可以是下列一个或多个字符串: de< CC de<, de< CFLAGS de<, de< CFLAGS_SHLIB de<, de< INCLUDEDIR de<, de< LD_SHLIB de<, de< LDFLAGS_SHLIB de<, de< LIBEXECDIR de<, de< LIBS_SHLIB de<, de< SBINDIR de<, de< SYSCONFDIR de<, de< TARGET de< 。 这个参数用于手动查询某些设置。比如,要手动处理Apache的C头文件,可以在Makefile中使用:
de<INC=-I`apxs -q INCLUDEDIR` de<
配置选项
- 此选项可以改变apxs的上述设置。
模板生成选项
-
此选项生成一个名为
name的子目录(见选项
de< -n de<)和其中的两个文件:一个是名为 de< mod_name.c de<的样板模块源程序,可以用来建立你自己的模块,或是学习使用apxs机制的良好开端;另一个则是对应的 de< Makefile de< ,用于编译和安装此模块。
DSO编译选项
-
此选项表示需要执行编译操作。它首先会编译C源程序(.c)
files为对应的目标代码文件(.o),然后连接这些目标代码和
files中其余的目标代码文件(.o和.a),以生成动态共享对象
dsofile 。如果没有指定
de< -o de< 选项,则此输出文件名由 files中的第一个文件名推测得到,也就是默认为 de< mod_name.so de< 。 -
明确指定所建立的动态共享对象的文件名,它不能从
files文件列表中推测得到。如果没有明确指定,则其文件名将为
de< mod_unknown.so de< 。 - 此选项直接传递到给编译命令,用于增加自定义的编译变量。
- 此选项直接传递到给编译命令,用于增加自定义的包含目录。
- 此选项直接传递到给连接命令,用于增加自定义的库文件目录。
- 此选项直接传递到给连接命令,用于增加自定义的库文件。
-
此选项用于向编译命令
de< libtool --mode=compile de< 中附加 compiler-flags ,以增加编译器特有的选项。 -
此选项用于向连接命令
de< libtool --mode=link de< 中附加 linker-flags ,以增加连接器特有的选项。
DSO的安装和配置选项
- 此选项表示需要执行安装操作,以安装一个或多个动态共享对象到服务器的 modules目录中。
-
此选项自动增加一个
de< LoadModule de<行到 de< httpd.conf de<文件中,以激活此模块,或者,如果此行已经存在,则启用之。 -
与
de< -a de< 选项类似,但是它增加的 de< LoadModule de<命令有一个井号前缀( de< # de<),即此模块已经准备就绪但尚未启用。 -
表示需要执行编辑操作,它可以与
de< -a de< 和 de< -A de< 选项配合使用,与 de< -i de< 操作类似,修改Apache的 de< httpd.conf de<文件,但是并不安装此模块。
举例
假设有一个扩展Apache功能的模块
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$ _
然后,必须修改Apache的配置,以确保有一个
/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]
$ _
如果配置文件中尚不存在,会增加下列的行:
如果你希望默认禁用此模块,可以使用
要快速测试apxs机制,可以建立一个Apache模块样板及其对应的Makefile :
Creating [DIR] foo
Creating [FILE] foo/Makefile
Creating [FILE] foo/modules.mk
Creating [FILE] foo/mod_foo.c
Creating [FILE] foo/.deps
$ _
然后,立即可以编译此样板模块为共享对象并加载到Apache服务器中:
$ 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