<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>List of core configure options</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="configure.html">Configure options</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ini.html">php.ini directives</a></div>
<div class="up"><a href="configure.html">Configure options</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="configure.about" class="sect1">
<h2 class="title">List of core configure options</h2>
<p class="para">
Below is a partial list of configure options used by the PHP
<var class="filename">configure</var> scripts when compiling in Unix-like
environments. Most configure options are listed in their appropriate
locations on the extension reference pages and not here. For a complete
up-to-date list of configure options, run <strong class="command">./configure --help</strong>
in your PHP source directory after running <strong class="command">autoconf</strong>
(see also the <a href="install.html" class="link">Installation chapter</a>).
You may also be interested in reading the
<a href="http://www.airs.com/ian/configure/" class="link external">» GNU configure</a> documentation for
information on additional <strong class="command">configure</strong> options such as
<em>--prefix=PREFIX</em>.
</p>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
These are only used at compile time. If you want to alter PHP's
runtime configuration, please see the chapter on <a href="configuration.html" class="link">Runtime Configuration</a>.
</p>
</p></blockquote>
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
<a href="configure.about.html#configure.options.misc" class="link">Miscellaneous</a>
</span>
</li>
<li class="listitem">
<span class="simpara">
<a href="configure.about.html#configure.options.php" class="link">PHP Behaviour</a>
</span>
</li>
<li class="listitem">
<span class="simpara">
<a href="configure.about.html#configure.options.servers" class="link">Server</a>
</span>
</li>
</ul>
<div class="sect2" id="configure.options">
<h3 class="title">Configure Options in PHP</h3>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
These options are only used in PHP as of PHP 4.1.0, although some are
available in older versions too. If you want to compile an older
version, some options will probably not be available.
</p>
</p></blockquote>
<div class="sect3" id="configure.options.misc">
<h4 class="title">Misc options</h4>
<dl>
<dt id="configure.enable-debug">
<span class="term">
<strong class="option configure">--enable-debug</strong>
</span>
<dd>
<p class="para">
Compile with debugging symbols.
</p>
</dd>
</dt>
<dt id="configure.with-layout">
<span class="term">
<strong class="option configure">--with-layout=TYPE</strong>
</span>
<dd>
<p class="para">
Sets how installed files will be laid out. Type is one of PHP (default)
or GNU.
</p>
</dd>
</dt>
<dt id="configure.with-pear">
<span class="term">
<strong class="option configure">--with-pear=DIR</strong>
</span>
<dd>
<p class="para">
Install PEAR in DIR (default PREFIX/lib/php).
</p>
</dd>
</dt>
<dt id="configure.without-pear">
<span class="term">
<strong class="option configure">--without-pear</strong>
</span>
<dd>
<p class="para">
Do not install PEAR.
</p>
</dd>
</dt>
<dt id="configure.enable-sigchild">
<span class="term">
<strong class="option configure">--enable-sigchild</strong>
</span>
<dd>
<p class="para">
Enable PHP's own SIGCHLD handler.
</p>
</dd>
</dt>
<dt id="configure.disable-rpath">
<span class="term">
<strong class="option configure">--disable-rpath</strong>
</span>
<dd>
<p class="para">
Disable passing additional runtime library search paths.
</p>
</dd>
</dt>
<dt id="configure.enable-libgcc">
<span class="term">
<strong class="option configure">--enable-libgcc</strong>
</span>
<dd>
<p class="para">
Enable explicitly linking against libgcc.
</p>
</dd>
</dt>
<dt id="configure.enable-php-streams">
<span class="term">
<strong class="option configure">--enable-php-streams</strong>
</span>
<dd>
<p class="para">
Include experimental PHP streams. Do not use unless you are testing the
code!
</p>
</dd>
</dt>
<dt id="configure.with-zlib-dir">
<span class="term">
<strong class="option configure">--with-zlib-dir[=DIR]</strong>
</span>
<dd>
<p class="para">
Define the location of zlib install directory.
</p>
</dd>
</dt>
<dt id="configure.enable-trans-sid">
<span class="term">
<strong class="option configure">--enable-trans-sid</strong>
</span>
<dd>
<p class="para">
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.
</p>
</dd>
</dt>
<dt id="configure.with-tsrm-pthreads">
<span class="term">
<strong class="option configure">--with-tsrm-pthreads</strong>
</span>
<dd>
<p class="para">
Use POSIX threads (default).
</p>
</dd>
</dt>
<dt id="configure.enable-shared">
<span class="term">
<strong class="option configure">--enable-shared[=PKGS]</strong>
</span>
<dd>
<p class="para">
Build shared libraries [default=yes].
</p>
</dd>
</dt>
<dt id="configure.enable-static">
<span class="term">
<strong class="option configure">--enable-static[=PKGS]</strong>
</span>
<dd>
<p class="para">
Build static libraries [default=yes].
</p>
</dd>
</dt>
<dt id="configure.enable-fast-install">
<span class="term">
<strong class="option configure">--enable-fast-install[=PKGS]</strong>
</span>
<dd>
<p class="para">
Optimize for fast installation [default=yes].
</p>
</dd>
</dt>
<dt id="configure.with-gnu-ld">
<span class="term">
<strong class="option configure">--with-gnu-ld</strong>
</span>
<dd>
<p class="para">
Assume the C compiler uses GNU ld [default=no].
</p>
</dd>
</dt>
<dt id="configure.disable-libtool-lock">
<span class="term">
<strong class="option configure">--disable-libtool-lock</strong>
</span>
<dd>
<p class="para">
Avoid locking (might break parallel builds).
</p>
</dd>
</dt>
<dt id="configure.with-pic">
<span class="term">
<strong class="option configure">--with-pic</strong>
</span>
<dd>
<p class="para">
Try to use only PIC/non-PIC objects [default=use both].
</p>
</dd>
</dt>
<dt id="configure.enable-memory-limit">
<span class="term">
<strong class="option configure">--enable-memory-limit</strong>
</span>
<dd>
<p class="para">
Compile with memory limit support.
(not available since PHP 5.2.1 - always enabled)
</p>
</dd>
</dt>
<dt id="configure.disable-url-fopen-wrapper">
<span class="term">
<strong class="option configure">--disable-url-fopen-wrapper</strong>
</span>
<dd>
<p class="para">
Disable the URL-aware fopen wrapper that allows
accessing files via HTTP or FTP.
(not available since PHP 5.2.5)
</p>
</dd>
</dt>
<dt id="configure.enable-versioning.php4">
<span class="term">
<strong class="option configure">--enable-versioning</strong>
</span>
<dd>
<p class="para">
Export only required symbols.
See INSTALL for more information.
</p>
</dd>
</dt>
</dl>
</div>
<div class="sect3" id="configure.options.php">
<h4 class="title">PHP options</h4>
<dl>
<dt id="configure.enable-maintainer-mode">
<span class="term">
<strong class="option configure">--enable-maintainer-mode</strong>
</span>
<dd>
<p class="para">
Enable make rules and dependencies not useful (and sometimes confusing)
to the casual installer.
</p>
</dd>
</dt>
<dt id="configure.with-config-file-path">
<span class="term">
<strong class="option configure">--with-config-file-path=PATH</strong>
</span>
<dd>
<p class="para">
Sets the path in which to look for <var class="filename">php.ini</var>, defaults to <em>PREFIX/lib</em>.
</p>
</dd>
</dt>
<dt id="configure.enable-safe-mode">
<span class="term">
<strong class="option configure">--enable-safe-mode</strong>
</span>
<dd>
<p class="para">
Enable safe mode by default.
</p>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">This feature has been
<em class="emphasis">DEPRECATED</em> as of PHP 5.3.0 and <em class="emphasis">REMOVED</em>
as of PHP 5.4.0.</p></div>
</dd>
</dt>
<dt id="configure.with-exec-dir">
<span class="term">
<strong class="option configure">--with-exec-dir[=DIR]</strong>
</span>
<dd>
<p class="para">
Only allow executables in DIR when in safe mode defaults to <em>/usr/local/php/bin</em>.
</p>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">This feature has been
<em class="emphasis">DEPRECATED</em> as of PHP 5.3.0 and <em class="emphasis">REMOVED</em>
as of PHP 5.4.0.</p></div>
</dd>
</dt>
<dt id="configure.enable-magic-quotes">
<span class="term">
<strong class="option configure">--enable-magic-quotes</strong>
</span>
<dd>
<p class="para">
Enable magic quotes by default.
</p>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">This feature has been
<em class="emphasis">DEPRECATED</em> as of PHP 5.3.0 and <em class="emphasis">REMOVED</em>
as of PHP 5.4.0.</p></div>
</dd>
</dt>
<dt id="configure.disable-short-tags">
<span class="term">
<strong class="option configure">--disable-short-tags</strong>
</span>
<dd>
<p class="para">
Disable the short-form <? start tag by default.
</p>
</dd>
</dt>
<dt id="configure.enable-zend-multibyte">
<span class="term">
<strong class="option configure">--enable-zend-multibyte</strong>
</span>
<dd>
<p class="para">
Enables multibyte code in the language parser and scanner to
be executed. When PHP is compiled with this option, it also
enables the
<a href="control-structures.declare.html#control-structures.declare.encoding" class="link">encoding</a>
directive in the
<a href="control-structures.declare.html" class="link">declare</a> construct.
</p>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">This feature has been
<em class="emphasis">DEPRECATED</em> as of PHP 5.3.0 and <em class="emphasis">REMOVED</em>
as of PHP 5.4.0.</p></div>
</dd>
</dt>
<dt id="configure.with-libdir">
<span class="term">
<strong class="option configure">--with-libdir</strong>
</span>
<dd>
<p class="para">
Specifies the directory where the libraries to build PHP exists on a
Unix system. For 64bit systems, its needed to specify this argument
to the <em>lib64</em> directory like:
<em>--with-libdir=lib64</em>.
</p>
</dd>
</dt>
</dl>
</div>
<div class="sect3" id="configure.options.servers">
<h4 class="title">SAPI options</h4>
<p class="para">
The following list contains the available SAPI&s (<em>Server
Application Programming Interface</em>) for PHP.
</p>
<dl>
<dt id="configure.with-aolserver">
<span class="term">
<strong class="option configure">--with-aolserver=DIR</strong>
</span>
<dd>
<p class="para">
Specify path to the installed AOLserver.
</p>
</dd>
</dt>
<dt id="configure.with-apxs">
<span class="term">
<strong class="option configure">--with-apxs[=FILE]</strong>
</span>
<dd>
<p class="para">
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.
</p>
</dd>
</dt>
<dt id="configure.with-apache">
<span class="term">
<strong class="option configure">--with-apache[=DIR]</strong>
</span>
<dd>
<p class="para">
Build a static Apache module. DIR is the top-level Apache build directory,
defaults to <var class="filename">/usr/local/apache</var>.
</p>
</dd>
</dt>
<dt id="configure.with-mod-charset">
<span class="term">
<strong class="option configure">--with-mod_charset</strong>
</span>
<dd>
<p class="para">
Enable transfer tables for mod_charset (Russian Apache).
</p>
</dd>
</dt>
<dt id="configure.with-apxs2">
<span class="term">
<strong class="option configure">--with-apxs2[=FILE]</strong>
</span>
<dd>
<p class="para">
Build shared Apache 2.0 module. FILE is the optional pathname to the Apache
apxs tool; defaults to apxs.
</p>
</dd>
</dt>
<dt id="configure.with-caudium">
<span class="term">
<strong class="option configure">--with-caudium=DIR</strong>
</span>
<dd>
<p class="para">
Build PHP as a Pike module for use with Caudium. DIR is the Caudium server
dir, with the default value <var class="filename">/usr/local/caudium/server</var>.
</p>
</dd>
</dt>
<dt id="configure.disable-cli">
<span class="term">
<strong class="option configure">--disable-cli</strong>
</span>
<dd>
<p class="para">
Available with PHP 4.3.0. Disable building the CLI version of PHP (this
forces <a href="configure.about.html#configure.without-pear" class="link">--without-pear</a>).
More information is available in the section about
<a href="features.commandline.html" class="link">Using PHP from the command line</a>.
</p>
</dd>
</dt>
<dt id="configure.enable-embed">
<span class="term">
<strong class="option configure">--enable-embed[=TYPE]</strong>
</span>
<dd>
<p class="para">
Enable building of the embedded SAPI library. TYPE is either
<em>shared</em> or <em>static</em>, which
defaults to <em>shared</em>. Available with PHP 4.3.0.
</p>
</dd>
</dt>
<dt id="configure.with-fhttpd">
<span class="term">
<strong class="option configure">--with-fhttpd[=DIR]</strong>
</span>
<dd>
<p class="para">
Build fhttpd module. DIR is the fhttpd sources directory, defaults to
<var class="filename">/usr/local/src/fhttpd</var>. No longer available as of PHP
4.3.0.
</p>
</dd>
</dt>
<dt id="configure.with-isapi">
<span class="term">
<strong class="option configure">--with-isapi=DIR</strong>
</span>
<dd>
<p class="para">
Build PHP as an ISAPI module for use with Zeus.
</p>
</dd>
</dt>
<dt id="configure.with-nsapi">
<span class="term">
<strong class="option configure">--with-nsapi=DIR</strong>
</span>
<dd>
<p class="para">
Specify path to the installed Netscape/iPlanet/SunONE Webserver.
</p>
</dd>
</dt>
<dt id="configure.with-phttpd">
<span class="term">
<strong class="option configure">--with-phttpd=DIR</strong>
</span>
<dd>
<p class="para">
No information yet.
</p>
</dd>
</dt>
<dt id="configure.with-pi3web">
<span class="term">
<strong class="option configure">--with-pi3web=DIR</strong>
</span>
<dd>
<p class="para">
Build PHP as a module for use with Pi3Web.
</p>
</dd>
</dt>
<dt id="configure.with-roxen">
<span class="term">
<strong class="option configure">--with-roxen=DIR</strong>
</span>
<dd>
<p class="para">
Build PHP as a Pike module. DIR is the base Roxen directory, normally
<var class="filename">/usr/local/roxen/server</var>.
</p>
</dd>
</dt>
<dt id="configure.enable-roxen-zts">
<span class="term">
<strong class="option configure">--enable-roxen-zts</strong>
</span>
<dd>
<p class="para">
Build the Roxen module using Zend Thread Safety.
</p>
</dd>
</dt>
<dt id="configure.with-servlet">
<span class="term">
<strong class="option configure">--with-servlet[=DIR]</strong>
</span>
<dd>
<p class="para">
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.
</p>
</dd>
</dt>
<dt id="configure.with-thttpd">
<span class="term">
<strong class="option configure">--with-thttpd=SRCDIR</strong>
</span>
<dd>
<p class="para">
Build PHP as thttpd module.
</p>
</dd>
</dt>
<dt id="configure.with-tux">
<span class="term">
<strong class="option configure">--with-tux=MODULEDIR</strong>
</span>
<dd>
<p class="para">
Build PHP as a TUX module (Linux only).
</p>
</dd>
</dt>
<dt id="configure.with-webjames">
<span class="term">
<strong class="option configure">--with-webjames=SRCDIR</strong>
</span>
<dd>
<p class="para">
Build PHP as a WebJames module (RISC OS only)
</p>
</dd>
</dt>
<dt id="configure.disable-cgi">
<span class="term">
<strong class="option configure">--disable-cgi</strong>
</span>
<dd>
<p class="para">
Disable building CGI version of PHP. Available with PHP 4.3.0.
</p>
<p class="para">
As of PHP 5.3.0 this argument enables FastCGI which previously
had to be enabled using <em>--enable-fastcgi</em>.
</p>
</dd>
</dt>
<dt id="configure.enable-force-cgi-redirect">
<span class="term">
<strong class="option configure">--enable-force-cgi-redirect</strong>
</span>
<dd>
<p class="para">
Enable the security check for internal server redirects. You should use
this if you are running the CGI version with Apache.
</p>
<p class="para">
As of PHP 5.3.0 this argument is enabled by default and no longer
exists. To disable this, the
<a href="ini.core.html#ini.cgi.force-redirect" class="link">cgi.force_redirect</a> ini directive
should be set to <em>0</em>.
</p>
</dd>
</dt>
<dt id="configure.enable-discard-path">
<span class="term">
<strong class="option configure">--enable-discard-path</strong>
</span>
<dd>
<p class="para">
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 <var class="filename">.htaccess</var>
security.
</p>
<p class="para">
As of PHP 5.3.0 this argument is disabled by default and no longer
exists. To enable this feature the cgi.discard_path ini directive
must be set to <em>1</em>.
</p>
</dd>
</dt>
<dt id="configure.with-fastcgi">
<span class="term">
<strong class="option configure">--with-fastcgi</strong>
</span>
<dd>
<p class="para">
Build PHP as FastCGI application. No longer available as of PHP 4.3.0,
instead you should use <strong class="option configure">--enable-fastcgi</strong>
.
</p>
</dd>
</dt>
<dt id="configure.enable-fastcgi">
<span class="term">
<strong class="option configure">--enable-fastcgi</strong>
</span>
<dd>
<p class="para">
If this is enabled, the CGI module will be built with support for FastCGI
also. Available since PHP 4.3.0
</p>
<p class="para">
As of PHP 5.3.0 this argument no longer exists and is enabled by
<em>--enable-cgi</em> instead.
</p>
</dd>
</dt>
<dt id="configure.disable-path-info-check">
<span class="term">
<strong class="option configure">--disable-path-info-check</strong>
</span>
<dd>
<p class="para">
If this is disabled, paths such as <var class="filename">/info.php/test?a=b</var>
will fail to work. Available since PHP 4.3.0.
For more information see the
<a href="http://httpd.apache.org/docs/current/mod/core.html#acceptpathinfo" class="link external">» Apache Manual</a>.
</p>
</dd>
</dt>
</dl>
</div>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="configure.html">Configure options</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ini.html">php.ini directives</a></div>
<div class="up"><a href="configure.html">Configure options</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
