PHP核心编译配置选项列表

PHP 的编译配置详细选项

简述：PHP?的编译配置详细选项
在详细选项上，除了上述的安装简介外，也可以在编译时加入其它的选项。

apache模块

语法: --with-apache=DIR

说明: 用本选项可以让 PHP 以apache的模块方式使用，DIR 的字符串可以是 /usr/local/apache 或其它安装apache的目录

范例: --with-apache=/var/lib/apache

fhttpd 服务器模块

语法: --with-fhttpd=DIR

说明: 若使用 fttpd 服务器，可以使用本指令编译 PHP。用模块的方式配合 fttpd 服务器，可以有较好的效率。

Adabas D 数据库

语法: --with-adabas=DIR

说明: 数据库系统为 AdabasD 数据库时需要加本选项。关于Adabas D 数据库的细节，可以参考 http://www.adabas.com。

范例: --with-adabas=/usr/local/adabasd

dBase 资料表

语法: --with-dbase

说明: 只要加本选项，不用其它的参数或函数库，PHP 就会让系统有存取 dBase资料表的功能。

filePro 数据库

语法: --with-filepro

说明: 不用指定数据库路径及其它函数库等，可以读取 filePro 数据库 (唯读)。

mSQL 数据库

语法: --with-msql=DIR

说明: 提供存取 mSQL 数据库。更多的细节请参考 mSQL 的网站 http://www.hughes.com.au。

范例: --with-msql=/usr/local/Hughes

MySQL 数据库

语法: --with-mysql=DIR

说明: 提供存取 MySQL 数据库。更多的细节请参考 MySQL 的网站 http://www.tcx.se。

范例: --with-mysql=/usr/local/mysql

iODBC 数据库装置

语法: --with-iodbc=DIR

说明: 提供 ODBC 数据库装置，用来存取后端数据库。更多的细节请参考 iODBC 的网站 http://www.iodbc.org。

范例: --with-iodbc=/usr/local/iodbc

OpenLink ODBC 数据库装置

语法: --with-openlink=DIR

说明: 使用 OpenLinkODBC 数据库装置，用来存取后端数据库。更多的细节请参考 OpenLink ODBC 的网站 http://www.openlinksw.com。

范例: --with-openlink=/usr/local/openlink

Oracle 数据库

语法: --with-oracle=DIR

说明: 使用 Oracle 数据库。Oracle 的版本要在 7.3 版以上。您也可以在 PHP 程序中使用环境变量 ORACLE_HOME 来指定 Oracle 的路径。更多有关 Oracle 的信息请参考 Oracle 的网站 http://www.oracle.com。

范例: --with-oracle=/export/app/oracle/product/7.3.2

PostgreSQL 数据库

语法: --with-pgsql=DIR

说明: 使用 PostgreSQL 数据库。更多有关 PostgreSQL 的信息请参考 PostgreSQL 的网站 http://www.postgreSQL.org 或台湾的 Mirror 站 http://postgresql.ccit.edu.tw。

范例: --with-pgsql=/usr/local/pgsql

Solid 数据库

语法: --with-solid=DIR

说明: 使用 Solid 数据库。更多有关 Solid 的信息请参考 Solid 的网站 http://www.solidtech.com。

范例: --with-solid=/usr/local/solid

Sybase 数据库

语法: --with-sybase=DIR

说明: 使用 Sybase 数据库。更多有关 Sybase 的信息请参考 Sybase 的网站 http://www.sybase.com。

范例: --with-sybase=/home/sybase

Sybase-CT 数据库

语法: --with-sybase-ct=DIR

说明: 使用 Sybase-CT 数据库。

范例: --with-sybase-ct=/home/sybase

Velocis 数据库

语法: --with-velocis=DIR

说明: 使用 Velocis 数据库。有关 Velocis 数据库的进一步资料请参考 Raima 公司的网站 http://www.raima.com。

范例: --with-velocis=/usr/local/velocis

自订 ODBC 数据库驱动程序

语法: --with-custom-odbc=DIR

说明: 使用自订的 ODBC 函数库。当然，在使用本方式时要指定 CUSTOM_ODBC_LIBS 及 CFLAGS 变量。例如在 QNX 机器上使用 Sybase SQL Anywhere 时可能要配置系统环境变量 CFLAGS=-DODBC_QNX、LDFLAGS=-lunix 及 CUSTOM_ODBC_LIBS="-ldblib-lodbc"，并要在 PHP 配置加入--with-custom-odbc=/usr/lib/sqlany50

范例: --with-custom-odbc=/usr/local/odbc

不使用 ODBC 数据库驱动程序

语法: --disable-unified-odbc

说明: 使用本选项将使所有的ODBC 数据库驱动程序不作用。本选项不用指定路径，而受本选项影响的选项有 --with-iodbc、--with-solid、--with-adabas、--with-velocis 及 --with-custom-odbc。

LDAP 目录协议

语法: --with-ldap=DIR

说明: 若要使用目录协议(Lightweight Directory Access Protocol, LDAP) 则必须要打开本选项。有关 LDAP 的细节，可以参考 RFC 文件的 RFC1777 及 RFC1778。

范例: --with-ldap=/usr/local/ldap.

mcrypt 编码函数库

语法: --with-mcrypt=DIR

说明: 当安装了 mcrypt 函数库后，可在编译 PHP 时加入本选项，让程序可以使用编解码功能。

范例: --with-mcrypt=/usr/local/include

Sys V 信号

语法: --enable-sysvsem

说明: 要使用 SysV 的信号 (semaphores) 机制，则要打开本选项。

XML 支持

语法: --with-xml

说明: 打开本选项可以支持James Clark's 写的 XML 解析程序库。

维护模式

语法: --enable-maintainer-mode

说明: 本选项一般不会打开，除非是PHP 开发人员比较有用。

正则表达式程序库

语法: --with-system-regex

说明: 若您需要额外的正则表达式功能，可以加入本选项。

PHP 配置文件

语法: --with-config-file-path=DIR

说明: 用来指定 php3.ini 或 php4.ini 的路径，供 PHP 初始化时使用。

范例: --with-config-file-path=/usr/local/lib

PHP 执行路径

语法: --with-exec-dir=DIR

说明: 有时为了系统的安全性考虑，会指定 PHP 程序一定要在哪个目录执行。

范例: --with-exec-dir=/usr/local/bin

调试模式

语法: --enable-debug

说明: 本选项一般不会使用，除非在开发 PHP 程序时比较有用。它可以显示额外的错误信息。

安全模式

语法: --enable-safe-mode

说明: 默认值是打开的，可以对系统安全提供比较多的保护。

变量追踪

语法: --enable-track-vars

说明: 让 PHP 能追踪 HTTP_GET_VARS、HTTP_POST_VARS 及 HTTP_COOKIE_VARS 三个变量，一般是打开的。

自动加引入字符

语法: --enable-magic-quotes

说明: 可让程序在执行时自动加入反斜线的引入字符。

打开调试器

语法: --enable-debugger

说明: 打开内建的 PHP 调试器。目前本功能还在实验阶段，尚未成熟。

取消路径 (discard path)

语法: --enable-discard-path

说明: 打开这个选项，用户就不能透过浏览器读取 .htaccess 等和系统安全相关的文件。

高精确度数学函数

语法: --enable-bcmath

说明: 打开高精确度函数。必须要先安装本函数库，本选项方有效。

强制 CGI 重定向

语法: --enable-force-cgi-redirect

范例: 若使用 CGIVERSION 模式来执行 PHP 的设，打开本选项会增加安全性。例如用户读http://my.host/cgi-bin/php/secret/doc.html 遇到比较了解 PHP 系统的黑客级用户可能会自已输入以下网址 http://my.host/secret/doc.html 来读取相关信息。若 PHP 和 Apache 编译在一起，让 PHP 变成 Apache 的一部份，则不需要加入本选项。

不使用短的标记

语法: --disable-short-tags

说明: 配置本选项后，PHP 的程序就不能使用短的 <? .... ?> 标记，一定要用 <?php ...... ?> 的长标记。

引入远端档宁

语法: --enable-url-includes

说明: 配置本选项可让 PHP 程序可以引入 (include) 远端的 HTTP 或 FTP 服务器中的文件。

关闭语法效果

语法: --disable-syntax-hl

说明: 使用本选项会关闭 PHP 语法的彩色效果。

函数库路径

语法: CPPFLAGS=-IDIR 及 LDFLAGS=-LDIR

说明: 若 PHP 在安全或编译所需的函数库在值得的路径，需要加入本选项，LDFLAGS 表示函数库的路径，CPPFLAGS 表示标头文件的路径。

范例: LDFLAGS=-L/my/lib/dir CPPFLAGS=-I/my/include/dir ./configure

PHP 手册
后退	章 3. 安装	前进

各种配置选项

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

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

·???????? 图像

·???????? 杂类

·???????? 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 手册。