Miscellaneous configure options
Below is a partial list of configure options used by the PHP configure scripts when compiling in Unix-like environments. Most configure options are listed in their appropriate locations and not here. For a complete up-to-date list of configure options, run ./configure --help in your PHP source directory after running autoconf (see also the Installation chapter). You may also be interested in reading the GNU configure documentation for information on additional configure options such as --prefix=PREFIX.
Note: These are only used at compile time. If you want to alter PHP's runtime configuration, please see the chapter on Runtime Configuration.
Configure Options in PHP 4
Note: These options are only used in PHP 4 as of PHP 4.1.0. Some are available in older versions of PHP 4, some even in PHP 3, some only in PHP 4.1.0. If you want to compile an older version, some options will probably not be available.
Graphics options
- --with-imagick
The imagick extension has been moved to PECL in PEAR and can be found here. Install instructions for PHP 4 can be found on the PEAR site.
Simply doing --with-imagick is only supported in PHP 3 unless you follow the instructions found on the PEAR site.
Misc options
- --enable-debug
Compile with debugging symbols.
- --with-layout=TYPE
Sets how installed files will be laid out. Type is one of PHP (default) or GNU.
- --with-pear=DIR
Install PEAR in DIR (default PREFIX/lib/php).
- --without-pear
Do not install PEAR.
- --enable-sigchild
Enable PHP's own SIGCHLD handler.
- --disable-rpath
Disable passing additional runtime library search paths.
- --enable-libgcc
Enable explicitly linking against libgcc.
- --enable-php-streams
Include experimental php streams. Do not use unless you are testing the code!
- --with-zlib-dir=<DIR>
Define the location of zlib install directory.
- --enable-trans-sid
Enable transparent session id propagation. Only valid for PHP 4.1.2 or less. From PHP 4.2.0, trans-sid feature is always compiled.
- --with-tsrm-pthreads
Use POSIX threads (default).
- --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].
- --enable-memory-limit
Compile with memory limit support.
- --disable-url-fopen-wrapper
Disable the URL-aware fopen wrapper that allows accessing files via HTTP or FTP.
- --enable-versioning
Export only required symbols. See INSTALL for more information.
- --with-imsp[=DIR]
Include IMSp support (DIR is IMSP's include dir and libimsp.a dir). PHP 3 only!
- --with-mck[=DIR]
Include Cybercash MCK support. DIR is the cybercash mck build directory, defaults to /usr/src/mck-3.2.0.3-linux for help look in extra/cyberlib. PHP 3 only!
- --with-mod-dav=DIR
Include DAV support through Apache's mod_dav, DIR is mod_dav's installation directory (Apache module version only!) PHP 3 only!
- --enable-debugger
Compile with remote debugging functions. PHP 3 only!
- --enable-versioning
Take advantage of versioning and scoping provided by Solaris 2.x and Linux. PHP 3 only!
PHP options
- --enable-maintainer-mode
Enable make rules and dependencies not useful (and sometimes confusing) to the casual installer.
- --with-config-file-path=PATH
Sets the path in which to look for php.ini, defaults to PREFIX/lib.
- --enable-safe-mode
Enable safe mode by default.
- --with-exec-dir[=DIR]
Only allow executables in DIR when in safe mode defaults to /usr/local/php/bin.
- --enable-magic-quotes
Enable magic quotes by default.
- --disable-short-tags
Disable the short-form <? start tag by default.
SAPI options
The following list contains the available SAPI&s (Server Application Programming Interface) for PHP.
- --with-aolserver=DIR
Specify path to the installed AOLserver.
- --with-apxs[=FILE]
Build shared Apache module. FILE is the optional pathname to the Apache apxs tool; defaults to apxs. Make sure you specify the version of apxs that is actually installed on your system and NOT the one that is in the apache source tarball.
- --with-apache[=DIR]
Build a static Apache module. DIR is the top-level Apache build directory, defaults to /usr/local/apache.
- --with-mod_charset
Enable transfer tables for mod_charset (Russian Apache).
- --with-apxs2[=FILE]
Build shared Apache 2.0 module. FILE is the optional pathname to the Apache apxs tool; defaults to apxs.
- --with-caudium=DIR
Build PHP as a Pike module for use with Caudium. DIR is the Caudium server dir, with the default value /usr/local/caudium/server.
- --disable-cli
Available with PHP 4.3.0. Disable building the CLI version of PHP (this forces --without-pear). More information is available in the section about Using PHP from the command line.
- --enable-embed[=TYPE]
Enable building of the embedded SAPI library. TYPE is either shared or static, which defaults to shared. Available with PHP 4.3.0.
- --with-fhttpd[=DIR]
Build fhttpd module. DIR is the fhttpd sources directory, defaults to /usr/local/src/fhttpd. No longer available as of PHP 4.3.0.
- --with-isapi=DIR
Build PHP as an ISAPI module for use with Zeus.
- --with-nsapi=DIR
Specify path to the installed Netscape/iPlanet/SunONE Webserver.
- --with-phttpd=DIR
No information yet.
- --with-pi3web=DIR
Build PHP as a module for use with Pi3Web.
- --with-roxen=DIR
Build PHP as a Pike module. DIR is the base Roxen directory, normally /usr/local/roxen/server.
- --enable-roxen-zts
Build the Roxen module using Zend Thread Safety.
- --with-servlet[=DIR]
Include servlet support. DIR is the base install directory for the JSDK. This SAPI requires the java extension must be built as a shared dl.
- --with-thttpd=SRCDIR
Build PHP as thttpd module.
- --with-tux=MODULEDIR
Build PHP as a TUX module (Linux only).
- --with-webjames=SRCDIR
Build PHP as a WebJames module (RISC OS only)
- --disable-cgi
Disable building CGI version of PHP. Available with PHP 4.3.0.
- --enable-force-cgi-redirect
Enable the security check for internal server redirects. You should use this if you are running the CGI version with Apache.
- --enable-discard-path
If this is enabled, the PHP CGI binary can safely be placed outside of the web tree and people will not be able to circumvent .htaccess security.
- --with-fastcgi
Build PHP as FastCGI application. No longer available as of PHP 4.3.0, instead you should use --enable-fastcgi.
- --enable-fastcgi
If this is enabled, the CGI module will be built with support for FastCGI also. Available since PHP 4.3.0
- --disable-path-info-check
If this is disabled, paths such as /info.php/test?a=b will fail to work. Available since PHP 4.3.0. For more information see the Apache Manual.