核心配置选项列表
下面是 PHP 的 configure 脚本使用的部分选项的列表，用于类 Unix 环境的编译。大部分配置选项在扩展模块参考页面适当的位置列出，而不是在这里。要查看所有可用配置选项的列表，在运行 autoconf 命令后在 PHP 的源代码目录运行 ./configure –help（参见安装与配置一章）。也可以阅读 » GNU configure 文档以获得有关 configure 命令的更详细信息，例如 –prefix=PREFIX。
Note:
这些选项只用在编译的时候。如果想要修改 PHP 的运行时配置，请阅读运行时配置。
`configure’ configures this package to adapt to many kinds of systems.
Usage: ./configure [OPTION]… [VAR=VALUE]…
To assign environment variables (e.g., CC, CFLAGS…), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables.
Defaults for the options are specified in brackets.
Configuration:
-h, –help display this help and exit
–help=short display options specific to this package
–help=recursive display the short help of all the included packages
-V, –version display version information and exit
-q, –quiet, –silent do not print `checking …’ messages
–cache-file=FILE cache test results in FILE [disabled]
-C, –config-cache alias for `–cache-file=config.cache’
-n, –no-create do not create output files
–srcdir=DIR find the sources in DIR [configure dir or `..’]
Installation directories:
–prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local]
–exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX]
By default, `make install’ will install all the files in
`/usr/local/bin’, `/usr/local/lib’ etc. You can specify
an installation prefix other than `/usr/local’ using `–prefix’,
for instance `–prefix=$HOME’.
For better control, use the options below.
Fine tuning of the installation directories:
–bindir=DIR user executables [EPREFIX/bin]
–sbindir=DIR system admin executables [EPREFIX/sbin]
–libexecdir=DIR program executables [EPREFIX/libexec]
–sysconfdir=DIR read-only single-machine data [PREFIX/etc]
–sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
–localstatedir=DIR modifiable single-machine data [PREFIX/var]
–libdir=DIR object code libraries [EPREFIX/lib]
–includedir=DIR C header files [PREFIX/include]
–oldincludedir=DIR C header files for non-gcc [/usr/include]
–datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
–datadir=DIR read-only architecture-independent data [DATAROOTDIR]
–infodir=DIR info documentation [DATAROOTDIR/info]
–localedir=DIR locale-dependent data [DATAROOTDIR/locale]
–mandir=DIR man documentation [DATAROOTDIR/man]
–docdir=DIR documentation root [DATAROOTDIR/doc/PACKAGE]
–htmldir=DIR html documentation [DOCDIR]
–dvidir=DIR dvi documentation [DOCDIR]
–pdfdir=DIR pdf documentation [DOCDIR]
–psdir=DIR ps documentation [DOCDIR]
System types:
–build=BUILD configure for building on BUILD [guessed]
–host=HOST cross-compile to build programs to run on HOST [BUILD]
–target=TARGET configure for building compilers for TARGET [HOST]
Optional Features and Packages:
–disable-option-checking ignore unrecognized –enable/–with options
–disable-FEATURE do not include FEATURE (same as –enable-FEATURE=no)
–enable-FEATURE[=ARG] include FEATURE [ARG=yes]
–with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
–without-PACKAGE do not use PACKAGE (same as –with-PACKAGE=no)
–with-libdir=NAME Look for libraries in …/NAME rather than …/lib
–disable-rpath Disable passing additional runtime library
search paths
–enable-re2c-cgoto Enable -g flag to re2c to use computed goto gcc extension
–disable-gcc-global-regs
whether to enable GCC global register variables
SAPI modules:
–with-apxs2=FILE Build shared Apache 2.0 Handler module. FILE is the optional
pathname to the Apache apxs tool apxs
–disable-cli Disable building CLI version of PHP
(this forces –without-pear)
–enable-embed=TYPE EXPERIMENTAL: Enable building of embedded SAPI library
TYPE is either ‘shared’ or ‘static’. TYPE=shared
–enable-fpm Enable building of the fpm SAPI executable
–with-fpm-user=USER Set the user for php-fpm to run as. (default: nobody)
–with-fpm-group=GRP Set the group for php-fpm to run as. For a system user, this
should usually be set to match the fpm username (default: nobody)
–with-fpm-systemd Activate systemd integration
–with-fpm-acl Use POSIX Access Control Lists
–with-litespeed Build PHP as litespeed module
–enable-phpdbg Build phpdbg
–enable-phpdbg-webhelper Build phpdbg web SAPI support
–enable-phpdbg-debug Build phpdbg in debug mode
–disable-cgi Disable building CGI version of PHP
General settings:
–enable-gcov Enable GCOV code coverage (requires LTP) – FOR DEVELOPERS ONLY!!
–enable-debug Compile with debugging symbols
–with-layout=TYPE Set how installed files will be laid out. Type can
be either PHP or GNU [PHP]
–with-config-file-path=PATH
Set the path in which to look for php.ini [PREFIX/lib]
–with-config-file-scan-dir=PATH
Set the path where to scan for configuration files
–enable-sigchild Enable PHP’s own SIGCHLD handler
–enable-libgcc Enable explicitly linking against libgcc
–disable-short-tags Disable the short-form = 0.9.6)
–with-kerberos=DIR OPENSSL: Include Kerberos support
–with-system-ciphers OPENSSL: Use system default cipher list instead of hardcoded value
–with-pcre-regex=DIR Include Perl Compatible Regular Expressions support.
DIR is the PCRE install prefix BUNDLED
–without-sqlite3=DIR Do not include SQLite3 support. DIR is the prefix to
SQLite3 installation directory.
–with-zlib=DIR Include ZLIB support (requires zlib >= 1.0.9)
–with-zlib-dir=
–enable-bcmath Enable bc style precision math functions
–with-bz2=DIR Include BZip2 support
–enable-calendar Enable support for calendar conversion
–disable-ctype Disable ctype functions
–with-curl=DIR Include cURL support
–enable-dba Build DBA with bundled modules. To build shared DBA
extension use –enable-dba=shared
–with-qdbm=DIR DBA: QDBM support
–with-gdbm=DIR DBA: GDBM support
–with-ndbm=DIR DBA: NDBM support
–with-db4=DIR DBA: Oracle Berkeley DB 4.x or 5.x support
–with-db3=DIR DBA: Oracle Berkeley DB 3.x support
–with-db2=DIR DBA: Oracle Berkeley DB 2.x support
–with-db1=DIR DBA: Oracle Berkeley DB 1.x support/emulation
–with-dbm=DIR DBA: DBM support
–with-tcadb=DIR DBA: Tokyo Cabinet abstract DB support
–without-cdb=DIR DBA: CDB support (bundled)
–disable-inifile DBA: INI support (bundled)
–disable-flatfile DBA: FlatFile support (bundled)
–disable-dom Disable DOM support
–with-libxml-dir=DIR DOM: libxml2 install prefix
–with-enchant=DIR Include enchant support.
GNU Aspell version 1.1.3 or higher required.
–enable-exif Enable EXIF (metadata from images) support
–disable-fileinfo Disable fileinfo support
–disable-filter Disable input filter support
–with-pcre-dir FILTER: pcre install prefix
–enable-ftp Enable FTP support
–with-openssl-dir=DIR FTP: openssl install prefix
–with-gd=DIR Include GD support. DIR is the GD library base
install directory BUNDLED
–with-vpx-dir=DIR GD: Set the path to libvpx install prefix
–with-jpeg-dir=DIR GD: Set the path to libjpeg install prefix
–with-png-dir=DIR GD: Set the path to libpng install prefix
–with-zlib-dir=DIR GD: Set the path to libz install prefix
–with-xpm-dir=DIR GD: Set the path to libXpm install prefix
–with-freetype-dir=DIR GD: Set the path to FreeType 2 install prefix
–enable-gd-native-ttf GD: Enable TrueType string function
–enable-gd-jis-conv GD: Enable JIS-mapped Japanese font support
–with-gettext=DIR Include GNU gettext support
–with-gmp=DIR Include GNU MP support
–with-mhash=DIR Include mhash support
–disable-hash Disable hash support
–without-iconv=DIR Exclude iconv support
–with-imap=DIR Include IMAP support. DIR is the c-client install prefix
–with-kerberos=DIR IMAP: Include Kerberos support. DIR is the Kerberos install prefix
–with-imap-ssl=DIR IMAP: Include SSL support. DIR is the OpenSSL install prefix
–with-interbase=DIR Include Firebird support. DIR is the Firebird base
install directory /opt/firebird
–enable-intl Enable internationalization support
–with-icu-dir=DIR Specify where ICU libraries and headers can be found
–disable-json Disable JavaScript Object Serialization support
–with-ldap=DIR Include LDAP support
–with-ldap-sasl=DIR LDAP: Include Cyrus SASL support
–enable-mbstring Enable multibyte string support
–disable-mbregex MBSTRING: Disable multibyte regex support
–disable-mbregex-backtrack
MBSTRING: Disable multibyte regex backtrack check
–with-libmbfl=DIR MBSTRING: Use external libmbfl. DIR is the libmbfl base
install directory BUNDLED
–with-onig=DIR MBSTRING: Use external oniguruma. DIR is the oniguruma install prefix.
If DIR is not set, the bundled oniguruma will be used
–with-mcrypt=DIR Include mcrypt support
–with-mysqli=FILE Include MySQLi support. FILE is the path
to mysql_config. If no value or mysqlnd is passed
as FILE, the MySQL native driver will be used
–enable-embedded-mysqli
MYSQLi: Enable embedded support
Note: Does not work with MySQL native driver!
–with-mysql-sock=SOCKPATH
MySQLi/PDO_MYSQL: Location of the MySQL unix socket pointer.
If unspecified, the default locations are searched
–with-oci8=DIR Include Oracle Database OCI8 support. DIR defaults to $ORACLE_HOME.
Use –with-oci8=instantclient,/path/to/instant/client/lib
to use an Oracle Instant Client installation
–with-odbcver=HEX Force support for the passed ODBC version. A hex number is expected, default 0x0300.
Use the special value of 0 to prevent an explicit ODBCVER to be defined.
–with-adabas=DIR Include Adabas D support /usr/local
–with-sapdb=DIR Include SAP DB support /usr/local
–with-solid=DIR Include Solid support /usr/local/solid
–with-ibm-db2=DIR Include IBM DB2 support /home/db2inst1/sqllib
–with-ODBCRouter=DIR Include ODBCRouter.com support /usr
–with-empress=DIR Include Empress support \$EMPRESSPATH
(Empress Version >= 8.60 required)
–with-empress-bcs=DIR
Include Empress Local Access support \$EMPRESSPATH
(Empress Version >= 8.60 required)
–with-birdstep=DIR Include Birdstep support /usr/local/birdstep
–with-custom-odbc=DIR Include user defined ODBC support. DIR is ODBC install base
directory /usr/local. Make sure to define CUSTOM_ODBC_LIBS and
have some odbc.h in your include dirs. f.e. you should define
following for Sybase SQL Anywhere 5.5.00 on QNX, prior to
running this configure script:
CPPFLAGS=\”-DODBC_QNX -DSQLANY_BUG\”
LDFLAGS=-lunix
CUSTOM_ODBC_LIBS=\”-ldblib -lodbc\”
–with-iodbc=DIR Include iODBC support /usr/local
–with-esoob=DIR Include Easysoft OOB support /usr/local/easysoft/oob/client
–with-unixODBC=DIR Include unixODBC support /usr/local
–with-dbmaker=DIR Include DBMaker support
–disable-opcache Disable Zend OPcache support
–enable-opcache-file Enable file based caching
–enable-pcntl Enable pcntl support (CLI/CGI only)
–disable-pdo Disable PHP Data Objects support
–with-pdo-dblib=DIR PDO: DBLIB-DB support. DIR is the FreeTDS home directory
–with-pdo-firebird=DIR PDO: Firebird support. DIR is the Firebird base
install directory /opt/firebird
–with-pdo-mysql=DIR PDO: MySQL support. DIR is the MySQL base directory
If no value or mysqlnd is passed as DIR, the
MySQL native driver will be used
–with-zlib-dir=DIR PDO_MySQL: Set the path to libz install prefix
–with-pdo-oci=DIR PDO: Oracle OCI support. DIR defaults to \$ORACLE_HOME.
Use –with-pdo-oci=instantclient,prefix,version
for an Oracle Instant Client SDK.
For example on Linux with 11.2 RPMs use:
–with-pdo-oci=instantclient,/usr,11.2
With 10.2 RPMs use:
–with-pdo-oci=instantclient,/usr,10.2.0.4
–with-pdo-odbc=flavour,dir
PDO: Support for ‘flavour’ ODBC driver.
include and lib dirs are looked for under ‘dir’.
‘flavour’ can be one of: ibm-db2, iODBC, unixODBC, generic
If ‘,dir’ part is omitted, default for the flavour
you have selected will be used. e.g.:
–with-pdo-odbc=unixODBC
will check for unixODBC under /usr/local. You may attempt
to use an otherwise unsupported driver using the \”generic\”
flavour. The syntax for generic ODBC support is:
–with-pdo-odbc=generic,dir,libname,ldflags,cflags
When built as ‘shared’ the extension filename is always pdo_odbc.so
–with-pdo-pgsql=DIR PDO: PostgreSQL support. DIR is the PostgreSQL base
install directory or the path to pg_config
–without-pdo-sqlite=DIR
PDO: sqlite 3 support. DIR is the sqlite base
install directory BUNDLED
–with-pgsql=DIR Include PostgreSQL support. DIR is the PostgreSQL
base install directory or the path to pg_config
–disable-phar Disable phar support
–disable-posix Disable POSIX-like functions
–with-pspell=DIR Include PSPELL support.
GNU Aspell version 0.50.0 or higher required
–with-libedit=DIR Include libedit readline replacement (CLI/CGI only)
–with-readline=DIR Include readline support (CLI/CGI only)
–with-recode=DIR Include recode support
–disable-session Disable session support
–with-mm=DIR SESSION: Include mm support for session storage
–enable-shmop Enable shmop support
–disable-simplexml Disable SimpleXML support
–with-libxml-dir=DIR SimpleXML: libxml2 install prefix
–with-snmp=DIR Include SNMP support
–with-openssl-dir=DIR SNMP: openssl install prefix
–enable-soap Enable SOAP support
–with-libxml-dir=DIR SOAP: libxml2 install prefix
–enable-sockets Enable sockets support
–enable-sysvmsg Enable sysvmsg support
–enable-sysvsem Enable System V semaphore support
–enable-sysvshm Enable the System V shared memory support
–with-tidy=DIR Include TIDY support
–disable-tokenizer Disable tokenizer support
–enable-wddx Enable WDDX support
–with-libxml-dir=DIR WDDX: libxml2 install prefix
–with-libexpat-dir=DIR WDDX: libexpat dir for XMLRPC-EPI (deprecated)
–disable-xml Disable XML support
–with-libxml-dir=DIR XML: libxml2 install prefix
–with-libexpat-dir=DIR XML: libexpat install prefix (deprecated)
–disable-xmlreader Disable XMLReader support
–with-libxml-dir=DIR XMLReader: libxml2 install prefix
–with-xmlrpc=DIR Include XMLRPC-EPI support
–with-libxml-dir=DIR XMLRPC-EPI: libxml2 install prefix
–with-libexpat-dir=DIR XMLRPC-EPI: libexpat dir for XMLRPC-EPI (deprecated)
–with-iconv-dir=DIR XMLRPC-EPI: iconv dir for XMLRPC-EPI
–disable-xmlwriter Disable XMLWriter support
–with-libxml-dir=DIR XMLWriter: libxml2 install prefix
–with-xsl=DIR Include XSL support. DIR is the libxslt base
install directory (libxslt >= 1.1.0 required)
–enable-zip Include Zip read/write support
–with-zlib-dir=DIR ZIP: Set the path to libz install prefix
–with-pcre-dir ZIP: pcre install prefix
–with-libzip=DIR ZIP: use libzip
–enable-mysqlnd Enable mysqlnd explicitly, will be done implicitly
when required by other extensions
–disable-mysqlnd-compression-support
Disable support for the MySQL compressed protocol in mysqlnd
–with-zlib-dir=DIR mysqlnd: Set the path to libz install prefix
PEAR:
–with-pear=DIR Install PEAR in DIR [PREFIX/lib/php]
–without-pear Do not install PEAR
Zend:
–enable-maintainer-zts Enable thread safety – for code maintainers only!!
–disable-inline-optimization
If building zend_execute.lo fails, try this switch
–enable-zend-signals Use zend signal handling
TSRM:
–with-tsrm-pth=pth-config
Use GNU Pth
–with-tsrm-st Use SGI’s State Threads
–with-tsrm-pthreads Use POSIX threads (default)
Libtool:
–enable-shared=PKGS Build shared libraries default=yes
–enable-static=PKGS Build static libraries default=yes
–enable-fast-install=PKGS
Optimize for fast installation default=yes
–with-gnu-ld Assume the C compiler uses GNU ld default=no
–disable-libtool-lock Avoid locking (might break parallel builds)
–with-pic Try to use only PIC/non-PIC objects default=use both
–with-tags=TAGS Include additional configurations automatic
Some influential environment variables:
CC C compiler command
CFLAGS C compiler flags
LDFLAGS linker flags, e.g. -L
nonstandard directory
you have headers in a nonstandard directory
CPP C preprocessor
YACC The `Yet Another Compiler Compiler’ implementation to use.
Defaults to the first program found out of: `bison -y’, `byacc’,
`yacc’.
YFLAGS The list of arguments that will be passed by default to $YACC.
This script will default YFLAGS to the empty string to avoid a
default value of `-d’ given by some make applications.
CXX C++ compiler command
CXXFLAGS C++ compiler flags
CXXCPP C++ preprocessor
Use these variables to override the choices made by `configure’ or to help
it to find libraries and programs with nonstandard names/locations.
Report bugs to the package provider.
PHP 配置选项
杂项选项
–enable-debug
编译时加入调试符号。
–with-layout=TYPE
设置被安装文件的布局。TYPE 是 PHP（默认）或 GNU。
–with-pear=DIR
在 DIR（默认为 PREFIX/lib/php）中安装 PEAR。
–without-pear
不安装 PEAR。
–enable-sigchild
使用 PHP 自带的 SIGCHLD 处理器。
–disable-rpath
禁用在搜索路径中传递其他运行库。
–enable-libgcc
启用 libgcc 的精确链接。
–enable-php-streams
包含试验性的 PHP 流。不要使用此选项，除非是要测试代码！
–with-zlib-dir[=DIR]
定义 zlib 的安装目录。
–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/非 PIC 对象 [default=use both]。
–enable-versioning
仅导出必须的符号。查看 INSTALL 文件以获得更多信息。
PHP 选项
–enable-maintainer-mode
对偶然安装一下的情形启用此选项，使得不检查编译规则和依赖关系。
–with-config-file-path=PATH
设置 php.ini 的搜索路径。默认为 PREFIX/lib。
–disable-short-tags
默认禁用短形式的开始标签
评论0