各种配置选项

以下是在类 UNIX 环境中编译时 PHP 的 configure 脚本所用的部分选项列表。大部分选项列在与之相关的地方而不是这里。要得到最新的,完整的配置选项列表,在 PHP 源程序目录中运行 autoconf 之后再运行 ./configure --help(参见安装一章)。有兴趣的还可以阅读 GNU configure 文档来得到有关 configure 的更多信息,例如 --prefix=PREFIX

注: 仅在编译时有用。如果要修改 PHP 的运行时配置,请看运行时配置一章。

PHP 4 中的配置选项

注: 这些选项仅能用于 PHP 自 4.1.0 版起。有一些可用于 PHP 4 较早的版本,有些甚至可用于 PHP 3,有些仅能用于 PHP 4.1.0。如果要编译老的版本,有些选项可能不能用。

图像选项

--with-imagick

Imagick 扩展被移到 PEAR 中的 PECL 中去了,可以在这里找到。PHP 4 中的安装指示可以在 PEAR 站点中找到。

只用 --with-imagick 仅在 PHP 3 中支持,除非依照 PEAR 站点的指示去做。

杂类选项

--enable-debug

编译时加入调试符号。

--with-layout=TYPE

设置安装后的文件布局。TYPE 可以是 PHP(默认值)或者 GNU。

--with-pear=DIR

将 PEAR 安装在 DIR 目录中(默认为 PREFIX/lib/php)。

--without-pear

不安装 PEAR。

--enable-sigchild

激活 PHP 自己的 SIGCHLD 句柄。

--disable-rpath

禁止传递附加的运行时库搜索路径。

--enable-libgcc

激活显式 libgcc 连接。

--enable-php-streams

包含试验的 PHP 流。除非是测试源代码,否则不要使用!

--with-zlib-dir=<DIR>

定义 zlib 的安装路径。

--with-ircg-config

ircg-config 脚本的路径。

--enable-trans-sid

激活透明的 session id 传播。此选项仅在 PHP 4.1.2 以及更低版本中有效。自 PHP 4.2.0 起,trans-sid 特性总是被编译入。

--with-tsrm-pthreads

使用 POSIX 线程(默认值)。

--enable-shared[=PKGS]

编译共享库 [default=yes]。

--enable-static[=PKGS]

编译静态库 [default=yes]。

--enable-fast-install[=PKGS]

为快速安装而优化 [default=yes]。

--with-gnu-ld

假定 C 编译器使用 GNU ld [default=no]。

--disable-libtool-lock

避免锁死(可能会破坏并行编译)。

--with-pic

尝试只使用 PIC/non-PIC 对象 [default=use both]。

--enable-memory-limit

编译时加入内存限制支持。

--disable-url-fopen-wrapper

禁止通过 URL 的 fopen wrapper,不能通过 HTTP 或 FTP 访问文件。

--enable-versioning

仅输出所需要的符号。更多信息见 INSTALL 文件。

--with-imsp[=DIR]

包含 IMSp 支持(DIR 是 IMSP 的 include 目录和 libimsp.a 目录)。仅用于 PHP 3!

--with-mck[=DIR]

包含 Cybercash MCK 支持。DIR 是 cybercash mck 编译目录,默认为 /usr/src/mck-3.2.0.3-linux。帮助见 extra/cyberlib。仅用于 PHP 3!

--with-mod-dav=DIR

包含通过 Apache 的 mod_dav 的 DAV 支持。DIR 是 mod_dav 的安装目录(仅用于 Apache 模块版本!)仅用于 PHP 3!

--enable-debugger

编译入远程调试函数。仅用于 PHP 3!

--enable-versioning

利用 Solaris 2.x 和 Linux 提供的版本控制与作用范围的优势。仅用于 PHP 3!

PHP 选项

--enable-maintainer-mode

激活将编译规则和未使用的(以及一些混淆的)依赖文件放入临时安装中。

--with-config-file-path=PATH

设定 php.ini 所在的路径,默认为 PREFIX/lib。

--enable-safe-mode

默认激活安全模式。

--with-exec-dir[=DIR]

安全模式下只允许此目录下执行程序。默认为 /usr/local/php/bin。

--enable-magic-quotes

默认激活 magic quotes。

--disable-short-tags

默认禁止简写的 PHP 开始标记 <?。

SAPI 选项

下面列出了 PHP 可用的 SAPI(Server Application Programming Interface)。

--with-aolserver=DIR

指定已安装的 AOLserver 的路径。

--with-apxs[=FILE]

编译共享 Apache 模块。FILE 是可选的 Apache 的 apxs 工具的路径,默认为 apxs。确保指定的 apxs 版本是安装后的文件而不是 Apache 源程序中包中的。

--with-apache[=DIR]

编译 Apache 模块。DIR 是 Apache 源程序的最高一级目录。默认为 /usr/local/apache

--with-mod_charset

激活 mod_charset 中的传递表(俄语版 Apache)。

--with-apxs2[=FILE]

编译共享的 Apache 2.0 模块。FILE 是可选的 Apache 的 apxs 工具的路径,默认为 apxs。

--with-caudium=DIR

将 PHP 编译为用于 Caudium 的 Pike 模块。DIR 是 Caudium server 的目录,默认为 /usr/local/caudium/server

--disable-cli

用于 PHP 4.3.0。禁用编译 PHP 的 CLI 版本(此选项也强制了 --without-pear)。更多信息见 PHP 的命令行模式一节。

--enable-embed[=TYPE]

编译为嵌入的 SAPI 库。TYPE 可以是 shared 或者 static,默认为 shared。用于 PHP 4.3.0。

--with-fhttpd[=DIR]

编译 fhttpd 模块。DIR 是 fhttpd 的源代码路径,默认为 /usr/local/src/fhttpd。自 PHP 4.3.0 起不可用。

--with-isapi=DIR

将 PHP 编译为 ISAPI 模块用于 Zeus。

--with-nsapi=DIR

指定已安装的 Netscape/iPlanet/SunONE 服务器路径。

--with-phttpd=DIR

暂无信息。

--with-pi3web=DIR

将 PHP 编译为用于 Pi3Web 的模块。

--with-roxen=DIR

将 PHP 编译为一个 Pike 模块。DIR 是 Roxen 的根目录,通常为 /usr/local/roxen/server

--enable-roxen-zts

编译 Roxen 模块,使用 Zend Thread Safety。

--with-servlet[=DIR]

包含 servlet 支持。DIR 是 JSDK 的基本安装目录。本 SAPI 需要 java 扩展必须被编译为共享的 dl。

--with-thttpd=SRCDIR

将 PHP 编译为 thttpd 模块。

--with-tux=MODULEDIR

将 PHP 编译为 TUX 模块(仅用于 Linux)。

--with-webjames=SRCDIR

将 PHP 编译为 WebJames 模块(仅用于 RISC 操作系统)。

--disable-cgi

禁止编译 PHP 的 CGI 版本。用于 PHP 4.3.0。

--enable-force-cgi-redirect

激活内部服务器重定向的安全检查。如果在 Apache 中以 CGI 方式运行则应使用此选项。

--enable-discard-path

激活此选项,PHP CGI 程序可以安全放置于 web 目录树之外,而且用户不可能绕过 .htaccess 安全机制。

--with-fastcgi

将 PHP 编译为 FastCGI 应用程序。自 PHP 4.3.0 起不可用。应使用 --enable-fastcgi 替代之。

--enable-fastcgi

激活此选项,CGI 模块也将支持 FastCGI。自 PHP 4.3.0 起可用。

--disable-path-info-check

禁止此选项,形如 /info.php/test?a=b 的路径将不能工作。自 PHP 4.3.0 起可用。更多信息参见 Apache 手册