<!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>
<div class="sect3" id="configure.options.misc">
<h4 class="title">Misc options</h4>
<dl>
<dt id="configure.enable-debug">
<strong class="option configure">--enable-debug</strong>
</dt>
<dd>
<p class="para">
Compile with debugging symbols.
</p>
</dd>
<dt id="configure.with-layout">
<strong class="option configure">--with-layout=TYPE</strong>
</dt>
<dd>
<p class="para">
Sets how installed files will be laid out. Type is one of PHP (default)
or GNU.
</p>
</dd>
<dt id="configure.with-pear">
<strong class="option configure">--with-pear=DIR</strong>
</dt>
<dd>
<p class="para">
Install PEAR in DIR (default PREFIX/lib/php).
</p>
</dd>
<dt id="configure.without-pear">
<strong class="option configure">--without-pear</strong>
</dt>
<dd>
<p class="para">
Do not install PEAR.
</p>
</dd>
<dt id="configure.enable-sigchild">
<strong class="option configure">--enable-sigchild</strong>
</dt>
<dd>
<p class="para">
Enable PHP's own SIGCHLD handler.
</p>
</dd>
<dt id="configure.disable-rpath">
<strong class="option configure">--disable-rpath</strong>
</dt>
<dd>
<p class="para">
Disable passing additional runtime library search paths.
</p>
</dd>
<dt id="configure.enable-libgcc">
<strong class="option configure">--enable-libgcc</strong>
</dt>
<dd>
<p class="para">
Enable explicitly linking against libgcc.
</p>
</dd>
<dt id="configure.enable-php-streams">
<strong class="option configure">--enable-php-streams</strong>
</dt>
<dd>
<p class="para">
Include experimental PHP streams. Do not use unless you are testing the
code!
</p>
</dd>
<dt id="configure.with-zlib-dir">
<strong class="option configure">--with-zlib-dir[=DIR]</strong>
</dt>
<dd>
<p class="para">
Define the location of zlib install directory.
</p>
</dd>
<dt id="configure.with-tsrm-pthreads">
<strong class="option configure">--with-tsrm-pthreads</strong>
</dt>
<dd>
<p class="para">
Use POSIX threads (default).
</p>
</dd>
<dt id="configure.enable-shared">
<strong class="option configure">--enable-shared[=PKGS]</strong>
</dt>
<dd>
<p class="para">
Build shared libraries [default=yes].
</p>
</dd>
<dt id="configure.enable-static">
<strong class="option configure">--enable-static[=PKGS]</strong>
</dt>
<dd>
<p class="para">
Build static libraries [default=yes].
</p>
</dd>
<dt id="configure.enable-fast-install">
<strong class="option configure">--enable-fast-install[=PKGS]</strong>
</dt>
<dd>
<p class="para">
Optimize for fast installation [default=yes].
</p>
</dd>
<dt id="configure.with-gnu-ld">
<strong class="option configure">--with-gnu-ld</strong>
</dt>
<dd>
<p class="para">
Assume the C compiler uses GNU ld [default=no].
</p>
</dd>
<dt id="configure.disable-libtool-lock">
<strong class="option configure">--disable-libtool-lock</strong>
</dt>
<dd>
<p class="para">
Avoid locking (might break parallel builds).
</p>
</dd>
<dt id="configure.with-pic">
<strong class="option configure">--with-pic</strong>
</dt>
<dd>
<p class="para">
Try to use only PIC/non-PIC objects [default=use both].
</p>
</dd>
<dt id="configure.enable-memory-limit">
<strong class="option configure">--enable-memory-limit</strong>
</dt>
<dd>
<p class="para">
Compile with memory limit support.
(not available since PHP 5.2.1 - always enabled)
</p>
</dd>
<dt id="configure.disable-url-fopen-wrapper">
<strong class="option configure">--disable-url-fopen-wrapper</strong>
</dt>
<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 id="configure.enable-versioning.php4">
<strong class="option configure">--enable-versioning</strong>
</dt>
<dd>
<p class="para">
Export only required symbols.
See INSTALL for more information.
</p>
</dd>
</dl>
</div>
<div class="sect3" id="configure.options.php">
<h4 class="title">PHP options</h4>
<dl>
<dt id="configure.enable-maintainer-mode">
<strong class="option configure">--enable-maintainer-mode</strong>
</dt>
<dd>
<p class="para">
Enable make rules and dependencies not useful (and sometimes confusing)
to the casual installer.
</p>
</dd>
<dt id="configure.with-config-file-path">
<strong class="option configure">--with-config-file-path=PATH</strong>
</dt>
<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 id="configure.enable-safe-mode">
<strong class="option configure">--enable-safe-mode</strong>
</dt>
<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 id="configure.with-exec-dir">
<strong class="option configure">--with-exec-dir[=DIR]</strong>
</dt>
<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 id="configure.enable-magic-quotes">
<strong class="option configure">--enable-magic-quotes</strong>
</dt>
<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 id="configure.disable-short-tags">
<strong class="option configure">--disable-short-tags</strong>
</dt>
<dd>
<p class="para">
Disable the short-form <? start tag by default.
</p>
</dd>
<dt id="configure.enable-zend-multibyte">
<strong class="option configure">--enable-zend-multibyte</strong>
</dt>
<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 id="configure.with-libdir">
<strong class="option configure">--with-libdir</strong>
</dt>
<dd>
<p class="para">
Specifies the directory where the libraries to build PHP exist 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>
</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">
<strong class="option configure">--with-aolserver=DIR</strong>
</dt>
<dd>
<p class="para">
Specify path to the installed AOLserver.
</p>
</dd>
<dt id="configure.with-apxs">
<strong class="option configure">--with-apxs[=FILE]</strong>
</dt>
<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 id="configure.with-apache">
<strong class="option configure">--with-apache[=DIR]</strong>
</dt>
<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 id="configure.with-mod-charset">
<strong class="option configure">--with-mod_charset</strong>
</dt>
<dd>
<p class="para">
Enable transfer tables for mod_charset (Russian Apache).
</p>
</dd>
<dt id="configure.with-apxs2">
<strong class="option configure">--with-apxs2[=FILE]</strong>
</dt>
<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 id="configure.with-caudium">
<strong class="option configure">--with-caudium=DIR</strong>
</dt>
<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 id="configure.disable-cli">
<strong class="option configure">--disable-cli</strong>
</dt>
<dd>
<p class="para">
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 id="configure.enable-phpdbg">
<strong class="option configure">--enable-phpdbg</strong>
</dt>
<dd>
<p class="para">
Enable phpdbg interactive debugger SAPI module support in PHP 5.6.x or later.
</p>
</dd>
<dt id="configure.enable-embed">
<strong class="option configure">--enable-embed[=TYPE]</strong>
</dt>
<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>.
</p>
</dd>
<dt id="configure.with-isapi">
<strong class="option configure">--with-isapi=DIR</strong>
</dt>
<dd>
<p class="para">
Build PHP as an ISAPI module for use with Zeus.
</p>
</dd>
<dt id="configure.with-nsapi">
<strong class="option configure">--with-nsapi=DIR</strong>
</dt>
<dd>
<p class="para">
Specify path to the installed Netscape/iPlanet/SunONE Webserver.
</p>
</dd>
<dt id="configure.with-phttpd">
<strong class="option configure">--with-phttpd=DIR</strong>
</dt>
<dd>
<p class="para">
No information yet.
</p>
</dd>
<dt id="configure.with-pi3web">
<strong class="option configure">--with-pi3web=DIR</strong>
</dt>
<dd>
<p class="para">
Build PHP as a module for use with Pi3Web.
</p>
</dd>
<dt id="configure.with-roxen">
<strong class="option configure">--with-roxen=DIR</strong>
</dt>
<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 id="configure.enable-roxen-zts">
<strong class="option configure">--enable-roxen-zts</strong>
</dt>
<dd>
<p class="para">
Build the Roxen module using Zend Thread Safety.
</p>
</dd>
<dt id="configure.with-servlet">
<strong class="option configure">--with-servlet[=DIR]</strong>
</dt>
<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 id="configure.with-thttpd">
<strong class="option configure">--with-thttpd=SRCDIR</strong>
</dt>
<dd>
<p class="para">
Build PHP as thttpd module.
</p>
</dd>
<dt id="configure.with-tux">
<strong class="option configure">--with-tux=MODULEDIR</strong>
</dt>
<dd>
<p class="para">
Build PHP as a TUX module (Linux only).
</p>
</dd>
<dt id="configure.with-webjames">
<strong class="option configure">--with-webjames=SRCDIR</strong>
</dt>
<dd>
<p class="para">
Build PHP as a WebJames module (RISC OS only)
</p>
</dd>
<dt id="configure.disable-cgi">
<strong class="option configure">--disable-cgi</strong>
</dt>
<dd>
<p class="para">
Disable building CGI version of PHP.
</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 id="configure.enable-force-cgi-redirect">
<strong class="option configure">--enable-force-cgi-redirect</strong>
</dt>
<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 id="configure.enable-discard-path">
<strong class="option configure">--enable-discard-path</strong>
</dt>
<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 id="configure.enable-fastcgi">
<strong class="option configure">--enable-fastcgi</strong>
</dt>
<dd>
<p class="para">
If this is enabled, the CGI module will be built with support for FastCGI
also.
</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 id="configure.disable-path-info-check">
<strong class="option configure">--disable-path-info-check</strong>
</dt>
<dd>
<p class="para">
If this is disabled, paths such as <var class="filename">/info.php/test?a=b</var>
will fail to work. For more information see the
<a href="http://httpd.apache.org/docs/current/mod/core.html#acceptpathinfo" class="link external">» Apache Manual</a>.
</p>
<p class="para">
As of PHP 5.3.0 this argument is enabled by default and no longer exists.
To disable this feature the <a href="ini.core.html#ini.cgi.fix-pathinfo" class="link">cgi.fix_pathinfo</a> ini directive must
be set to <em>0</em>.
</p>
</dd>
</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>
