`
liudaoru
  • 浏览: 1576257 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

apxs - Apache 扩展工具

阅读更多

From: http://lamp.linux.gov.cn/Apache/ApacheMenu/programs/apxs.html

 

本篇译者:金步国(其他作品

 

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

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

$ httpd -l

该命令的输出列表中应该有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源程序。

top

语法

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 ...

top

选项

一般选项

-n modname
它明确设置了 -i(安装)和 -g(模板生成)选项的模块名称。对 -g 选项,它是必须的;对 -i 选项,apxs工具会根据源代码判断,或(在失败的情况下)按文件名推测出这个模块的名称。

查询选项

-q
查询某种apxs设置的信息。该选项的query参数可以是下列一个或多个字符串:CCCFLAGSCFLAGS_SHLIBINCLUDEDIRLD_SHLIBLDFLAGS_SHLIBLIBEXECDIRLIBS_SHLIBSBINDIRSYSCONFDIR,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和.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 ,以增加连接器特有的选项。

DSO的安装和配置选项

-i
此选项表示需要执行安装操作,以安装一个或多个动态共享对象到服务器的modules目录中。
-a
此选项自动增加一个LoadModule行到httpd.conf文件中,以激活此模块,或者,如果此行已经存在,则启用之。
-A
与 -a 选项类似,但是它增加的LoadModule命令有一个井号前缀(#),即此模块已经准备就绪但尚未启用。
-e
表示需要执行编辑操作,它可以与 -a 和 -A 选项配合使用,与 -i 操作类似,修改Apache的httpd.conf文件,但是并不安装此模块。
top

举例

假设有一个扩展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 -i -A mod_foo.c

要快速测试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
$ _

分享到:
评论
1 楼 liudaoru 2008-11-17  
From:[url] http://linux.chinaunix.net/bbs/viewthread.php?tid=504990&page=1[/url]
rpm -ql httpd-devel

相关推荐

    apache扩展模块开发工具apxs

    apache扩展模块开发工具,可以在Windows平台下生成并编译模块文件(*.so)。将文件放在apache的bin目录下。 生成一个模块文件命令语法: apxs -g -n helloworld。 该命令会自动生成一个文件夹helloworld,并含有mod_...

    C语言-apache mod(模块开发)-采用centos7.2 apxs的开发范例

    理解Apache模块的工作原理以及如何利用apxs工具能够帮助开发者更有效地扩展和定制Apache服务器的功能。在实际开发过程中,还需要熟悉Apache的API,学习如何处理请求、响应、配置指令以及与其他模块交互。

    Apache HTTP Server Version 2.2 文档(2013.4.10最新)

    apxs - Apache 扩展工具 configure - 配置源代码树 dbmmanage - 管理DBM格式的用户认证文件 htcacheclean - 清理磁盘缓冲区 htdbm - 操作DBM密码数据库 htdigest - 管理用于摘要认证的用户文件 htpasswd - 管理用于...

    window环境下apache模块开发工具apxs及安装使用详细说明

    在Windows环境下,apxs(Apache eXtenSion tool)是一个非常重要的工具,它简化了Apache模块的编译和安装过程。本文将详细介绍apxs的安装和使用方法,以及在Windows环境中进行Apache模块开发的相关知识点。 **apxs...

    windows 下apxs

    Apache服务器是世界上最流行的开源Web服务器,它支持许多模块来扩展其功能。`apxs`工具是Apache HTTP服务器的一部分,主要用于在Unix-like系统上构建和管理动态加载的模块(通常用C语言编写)。然而,`apxs`在...

    apxs是用编译和安装 apache 服务器的扩展模块(mod)的工具

    apxs is a tool for building and installing extension modules for the Apache HyperText Transfer Protocol (HTTP) server. apxs是用编译和安装 apache 服务器的扩展模块(mod)的工具

    Apache WebSphere服务器部署方案

    Apache WebSphere服务器是业界广泛采用的一种解决方案,它能够提供强大的处理能力和灵活的扩展性。本文将详细介绍如何在Linux环境下部署Apache Web服务器,并与IBM WebSphere Application Server (WAS)集成,实现高...

    安装apache mysql php 手册&&开发apache,php扩展模块方法

    Apache扩展模块的开发涉及Apache的API,可以参考Apache文档和源代码来编写模块代码,然后通过同样的编译和安装过程将其集成到Apache中。PHP扩展模块则需要使用PHP的C API,遵循PHP的模块结构编写,并通过`phpize`...

    APACHE安装笔记

    - Mod_gzip:使用Apache的apxs工具安装,命令为:`/path/to/apache/bin/apxs -i -a -c mod_gzip.c`。 - 其他工具,如cronolog,按照其官方提供的安装指南操作。 5. **升级与维护**: 通过模块化和通用的安装方法...

    Linux环境下apache+tomcat共存

    - 使用`./configure`命令,指定Apache的apxs工具的位置 - 运行`make`来编译模块,并将生成的`.so`文件复制到Apache的模块目录 5. **配置Apache**: - 在Apache的配置目录(如`/usr/local/apache/conf/`)下创建...

    linux 下配置 Apache 详解

    Apache 的核心优势在于它能够通过动态共享对象 (DSO) 的方式安装和配置各种扩展模块,这使得用户可以根据需求轻松地启用或禁用不同的功能。 #### 二、Web 应用容量规划 在部署 Web 服务之前,进行合理的容量规划至...

    Apache2.0中文手册

    Apache扩展工具(APache eXtension Tool) (apxs) 这是一个perl脚本,用于编译模块源代码为动态共享对象(Dynamic Shared Objects)(DSO),并帮助安装到Apache网络服务器中。 见: Manual Page: apxs 证书(Certificate)

    关于apache mod_hearders漏洞

    在手动修复这些问题时,我们首先需要确保所有必要的工具都已安装,例如`apxs`,这是一个Apache扩展程序的链接器和编译器,用于管理和构建Apache模块。在提供的内容中,我们可以看到如何使用`apxs`来编译和安装mod_...

    mod-fastcgi-2.4.6 for apache2.40

    安装时,通常需要将这些库文件解压,然后使用Apache的配置工具(如`apxs`)编译并链接到Apache服务器中。 **安装与配置** 在安装mod_fastcgi时,通常需要执行以下步骤: 1. 解压缩下载的文件。 2. 使用`./...

    如何在apache中配置限制出口宽带速度--->针对某一类文件的和某种条件下的文件限速

    /usr/apache2.4/bin/apxs -c -i -a mod_limitipconn.c ``` - **解压mod_Bw** ```bash cd .. tar xvf mod_bw-0.92.tgz ``` 注意:因为Apache新版本的问题,需要将`mod_bw.c`中的所有`remote_addr`替换为`...

    安装apache中文目录过程

    进入mod_encoding源码目录,使用`./configure`命令指定Apache的apxs工具和iconv_hook的头文件路径: ``` ./configure --with-apxs=/path/to/apxs --with-iconv-hook=/usr/local/include make ``` 确认生成了`...

    SVN+Apache+Trac安装配置

    setuptools 是 Python 的扩展包管理工具。 - **安装 setuptools-0.6c11**: ```shell python setup.py install ``` #### 11. 安装 Trac 最后一步是安装 Trac,这是一个流行的项目管理与跟踪工具。 - **下载并...

    linux下集成Apache与weblogic.pdf

    安装`mod_wl_20.so`模块,进入其所在目录,使用`apxs`工具进行安装: ``` perl APACHE_HOME/bin/apxs -i -a -n weblogic mod_wl_20.so ``` 这会将模块复制到`APACHE_HOME/modules`目录,并在`httpd.conf`中添加`...

Global site tag (gtag.js) - Google Analytics