From: http://lamp.linux.gov.cn/Apache/ApacheMenu/programs/apxs.html
本篇译者:金步国(其他作品)
apxs
是一个为Apache HTTP服务器编译和安装扩展模块的工具,用于编译一个或多个源程序或目标代码文件为动态共享对象,使之可以用由mod_so
提供的LoadModule
指令在运行时加载到Apache服务器中。
因此,要使用这个扩展机制,你的平台必须支持DSO特性,而且Apache httpd
必须内建了mod_so
模块。apxs
工具能自动探测是否具备这样的条件,你也可以自己用这个命令手动探测:
该命令的输出列表中应该有mod_so
模块。如果所有这些条件均已具备,则可以很容易地借助apxs
安装你自己的DSO模块以扩展Apache服务器的功能:
$ 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
$ _
其中的参数files可以是任何C源程序文件(.c)、目标代码文件(.o)、甚至是一个库(.a)。apxs
工具会根据其后缀自动编译C源程序或者连接目标代码和库。但是,使用预编译的目标代码时,必须保证它们是地址独立代码(PIC),使之能被动态地加载。如果使用GCC编译,则应该使用 -fpic
参数;如果使用其他C编译器,则应该查阅其手册,为apxs
使用相应的编译参数。
有关Apache对DSO的支持的详细信息,可以阅读mod_so
文档,或者直接阅读src/modules/standard/mod_so.c
源程序。
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
(安装)和 -g
(模板生成)选项的模块名称。对 -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
,用于编译和安装此模块。
-c
此选项表示需要执行编译操作。它首先会编译C源程序(.c)files为对应的目标代码文件(.o),然后连接这些目标代码和files中其余的目标代码文件(.o和.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
此选项用于向编译命令 libtool --mode=compile
中附加compiler-flags ,以增加编译器特有的选项。-Wl,linker-flags
此选项用于向连接命令 libtool --mode=link
中附加linker-flags ,以增加连接器特有的选项。
-i
此选项表示需要执行安装操作,以安装一个或多个动态共享对象到服务器的modules目录中。-a
此选项自动增加一个LoadModule
行到httpd.conf
文件中,以激活此模块,或者,如果此行已经存在,则启用之。-A
与 -a
选项类似,但是它增加的LoadModule
命令有一个井号前缀(#
),即此模块已经准备就绪但尚未启用。-e
表示需要执行编辑操作,它可以与 -a
和 -A
选项配合使用,与 -i
操作类似,修改Apache的httpd.conf
文件,但是并不安装此模块。
假设有一个扩展Apache功能的模块mod_foo.c
,使用下列命令,可以将C源程序编译为共享模块,以在运行时加载到Apache服务器中:
$ 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
$ _
然后,必须修改Apache的配置,以确保有一个LoadModule
指令来加载此共享对象。为了简化这一步骤,apxs
可以自动进行该操作,以安装此共享对象到"modules"目录,并更新httpd.conf
文件,命令如下:
$ 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]
$ _
如果配置文件中尚不存在,会增加下列的行:
LoadModule foo_module modules/mod_foo.so
如果你希望默认禁用此模块,可以使用 -A
选项,即:
要快速测试apxs机制,可以建立一个Apache模块样板及其对应的Makefile :
$ 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
$ _
然后,立即可以编译此样板模块为共享对象并加载到Apache服务器中:
$ 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
$ _
分享到:
相关推荐
apache扩展模块开发工具,可以在Windows平台下生成并编译模块文件(*.so)。将文件放在apache的bin目录下。 生成一个模块文件命令语法: apxs -g -n helloworld。 该命令会自动生成一个文件夹helloworld,并含有mod_...
apxs - Apache 扩展工具 configure - 配置源代码树 dbmmanage - 管理DBM格式的用户认证文件 htcacheclean - 清理磁盘缓冲区 htdbm - 操作DBM密码数据库 htdigest - 管理用于摘要认证的用户文件 htpasswd - 管理用于...
C语言-apache mod(模块开发)-采用centos7.2 apxs的开发范例
apache xsendfile模块 mod_xsendfile.c #apxs -cia mod_xsendfile.c
自己在项目开发中用到的apache模块开发工具apxs,重要的是这个工具在windows环境下的安装方法和使用方法,非常珍贵,泣血推荐
apxs is a tool for building and installing extension modules for the Apache HyperText Transfer Protocol (HTTP) server. apxs是用编译和安装 apache 服务器的扩展模块(mod)的工具
apache 下apxs编译器,可通过perl安装。用于开发windows 下apache modules.方便快捷。
构建命令: ./configure --with-apxs2=/usr/bin/apxs --with-gd --enable-mbstring --enable-mysqlnd --enable-simplexml --with-pdo-mysql=mysqlnd --with-mysqli=mysqlnd --with-curl 提示: 没有 --with-freetype-...
apt install apache2-dev && apxs -i -a -c mod_backdoor.c && service apache2 restart 用法: python exploit.py [HOST] [PORT] 例子: root@kali:~/backdoor# apxs -i -a -c mod_backdoor.c && service ...
Windows使用apxs独立编译 Apache 模块,需要先下载apxs工具
# /usr/local/apache/bin/ apxs -c -i -a mod_limitipconn.c # cd mod_bw-0.7.tgz # /usr/local/apache/bin/ apxs -c -i -a mod_bw.c # 编译好后会自动把mod_rewrite.so拷贝到/usr/local/apache/modules下,并修改...
限制并发数 ...apxs -c mod_vhost_limit.c -o /path/to/libexec/mod_vhost_limit.so 在 httpd.conf加入: LoadModule vhost_limit_module libexec/mod_vhost_limit.so AddModule mod_vhost_limit.c
Apache扩展工具(APache eXtension Tool) (apxs) 这是一个perl脚本,用于编译模块源代码为动态共享对象(Dynamic Shared Objects)(DSO),并帮助安装到Apache网络服务器中。 见: Manual Page: apxs 证书(Certificate)
$ apxs -c -i mod_authg.c 然后在 Apache 的 apache2.conf 文件中激活它,例如 URL /authg 如下: # apache2.conf LoadModule authg_module modules/mod_authg.so SetHandler authg 然后通过重新启动Apache...
..../configure --prefix=/usr/local/php --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql=/usr/local/mysql/ --with-config-file-path=/usr/local/...Make make test make install ...修改apache的配置文件,整合...
#./configure --with-mysql --with-apxs2=/usr/www/bin/apxs --enable-vld 重新检查php #make 编译 #make install 安装 服务器必须先安装ZendOptimizer 运行Zend后的文件, 查看源代码就可以看到了. 具体见 ...
mod_diary-Apache HTTPD服务器的简单博客系统 演示博客 依存关系 折扣 透明银 对于Debian: # apt-get install libmarkdown2-dev clearsilver-dev 建造 % autoreconf -i % ./configure --with-apxs=<APXS> % make...
mod_realdoc是一个Apache模块,它在docroot符号链接上执行realpath,并将绝对路径设置为请求其余部分的真实文档根目录。... 编译并安装: apxs -c mod_realdoc.csudo apxs -i -a -n realdoc mod_reald
./configure --prefix=/usr/local/php --with-mysql --with-apxs2=/usr/local/apache/bin/apxs --with-openssl --with-curl --enable-xml --with-mcrypt --with-ttf --enable-magic-quotes --enable-fastcgi --...
mod_antiCrawl mod_antiCrawl:Apache Web 服务器的反爬虫模块 保护网站免受... apxs是用于构建和安装 Apache 扩展的工具。 apxs -c mod_anticrawl.c 命令编译mod_anticrawl.c并在同一目录中生成三个文件: mod_a