goba Tue Jun 1 15:39:12 2004 EDT
Added files:
/phpdoc/en/appendices configure.xml
/phpdoc/en/appendices/configure misc.xml php.xml servers.xml
Removed files:
/phpdoc/en/chapters install.configure.databases.xml
install.configure.graphics.xml
install.configure.misc.xml
install.configure.php.xml
install.configure.servers.xml
install.configure.xml
Modified files:
/phpdoc/en/appendices reserved.xml
Log:
moving the configure options list around to the appendix as discussed (since noone
objected on the week I provided for objections)
http://cvs.php.net/diff.php/phpdoc/en/appendices/reserved.xml?r1=1.41&r2=1.42&ty=u
Index: phpdoc/en/appendices/reserved.xml
diff -u phpdoc/en/appendices/reserved.xml:1.41 phpdoc/en/appendices/reserved.xml:1.42
--- phpdoc/en/appendices/reserved.xml:1.41 Mon May 24 15:14:27 2004
+++ phpdoc/en/appendices/reserved.xml Tue Jun 1 15:39:11 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.41 $ -->
+<!-- $Revision: 1.42 $ -->
<appendix id="reserved">
<title>List of Reserved Words</title>
http://cvs.php.net/co.php/phpdoc/en/appendices/configure.xml?r=1.1&p=1
Index: phpdoc/en/appendices/configure.xml
+++ phpdoc/en/appendices/configure.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect1 id="configure">
<title>List of core configure options</title>
<para>
Below is a partial list of configure options used by the PHP
<filename>configure</filename> 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 <command>./configure --help</command>
in your PHP source directory after running <command>autoconf</command>
(see also the <link linkend="installation">Installation chapter</link>).
You may also be interested in reading the
<ulink url="&url.gnu.configure;">GNU configure</ulink> documentation for
information on additional <command>configure</command> options such as
<literal>--prefix=PREFIX</literal>.
</para>
<note>
<para>
These are only used at compile time. If you want to alter PHP's
runtime configuration, please see the chapter on <link
linkend="configuration">Runtime Configuration</link>.
</para>
</note>
<itemizedlist>
<listitem>
<para>
<link linkend="configure.options.misc">Miscellaneous</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="configure.options.php">PHP Behaviour</link>
</para>
</listitem>
<listitem>
<para>
<link linkend="configure.options.servers">Server</link>
</para>
</listitem>
</itemizedlist>
<sect2 id="configure.options">
<title>Configure Options in PHP 4</title>
<note>
<para>
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.
</para>
</note>
&appendices.configure.misc;
&appendices.configure.php;
&appendices.configure.servers;
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc/en/appendices/configure/misc.xml?r=1.1&p=1
Index: phpdoc/en/appendices/configure/misc.xml
+++ phpdoc/en/appendices/configure/misc.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect3 id="configure.options.misc">
<title>Misc options</title>
<variablelist>
<varlistentry id="configure.enable-debug">
<term>
<option role="configure">--enable-debug</option>
</term>
<listitem>
<para>
Compile with debugging symbols.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-layout">
<term>
<option role="configure">--with-layout=TYPE</option>
</term>
<listitem>
<para>
Sets how installed files will be laid out. Type is one of PHP (default)
or GNU.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-pear">
<term>
<option role="configure">--with-pear=DIR</option>
</term>
<listitem>
<para>
Install PEAR in DIR (default PREFIX/lib/php).
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.without-pear">
<term>
<option role="configure">--without-pear</option>
</term>
<listitem>
<para>
Do not install PEAR.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-sigchild">
<term>
<option role="configure">--enable-sigchild</option>
</term>
<listitem>
<para>
Enable PHP's own SIGCHLD handler.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-rpath">
<term>
<option role="configure">--disable-rpath</option>
</term>
<listitem>
<para>
Disable passing additional runtime library search paths.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-libgcc">
<term>
<option role="configure">--enable-libgcc</option>
</term>
<listitem>
<para>
Enable explicitly linking against libgcc.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-php-streams">
<term>
<option role="configure">--enable-php-streams</option>
</term>
<listitem>
<para>
Include experimental PHP streams. Do not use unless you are testing the
code!
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-zlib-dir">
<term>
<option role="configure">--with-zlib-dir[=DIR]</option>
</term>
<listitem>
<para>
Define the location of zlib install directory.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-trans-sid">
<term>
<option role="configure">--enable-trans-sid</option>
</term>
<listitem>
<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.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-tsrm-pthreads">
<term>
<option role="configure">--with-tsrm-pthreads</option>
</term>
<listitem>
<para>
Use POSIX threads (default).
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-shared">
<term>
<option role="configure">--enable-shared[=PKGS]</option>
</term>
<listitem>
<para>
Build shared libraries [default=yes].
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-static">
<term>
<option role="configure">--enable-static[=PKGS]</option>
</term>
<listitem>
<para>
Build static libraries [default=yes].
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-fast-install">
<term>
<option role="configure">--enable-fast-install[=PKGS]</option>
</term>
<listitem>
<para>
Optimize for fast installation [default=yes].
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-gnu-ld">
<term>
<option role="configure">--with-gnu-ld</option>
</term>
<listitem>
<para>
Assume the C compiler uses GNU ld [default=no].
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-libtool-lock">
<term>
<option role="configure">--disable-libtool-lock</option>
</term>
<listitem>
<para>
Avoid locking (might break parallel builds).
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-pic">
<term>
<option role="configure">--with-pic</option>
</term>
<listitem>
<para>
Try to use only PIC/non-PIC objects [default=use both].
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-memory-limit">
<term>
<option role="configure">--enable-memory-limit</option>
</term>
<listitem>
<para>
Compile with memory limit support.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-url-fopen-wrapper">
<term>
<option role="configure">--disable-url-fopen-wrapper</option>
</term>
<listitem>
<para>
Disable the URL-aware fopen wrapper that allows
accessing files via HTTP or FTP.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-versioning.php4">
<term>
<option role="configure">--enable-versioning</option>
</term>
<listitem>
<para>
Export only required symbols.
See INSTALL for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-ismp">
<term>
<option role="configure">--with-imsp[=DIR]</option>
</term>
<listitem>
<para>
Include IMSp support (DIR is IMSP's include dir and libimsp.a dir).
PHP 3 only!
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-mck">
<term>
<option role="configure">--with-mck[=DIR]</option>
</term>
<listitem>
<para>
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!
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-mod-dav">
<term>
<option role="configure">--with-mod-dav=DIR</option>
</term>
<listitem>
<para>
Include DAV support through Apache's mod_dav,
DIR is mod_dav's installation directory (Apache
module version only!) PHP 3 only!
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-debugger">
<term>
<option role="configure">--enable-debugger</option>
</term>
<listitem>
<para>
Compile with remote debugging functions. PHP 3 only!
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-versioning.php3">
<term>
<option role="configure">--enable-versioning</option>
</term>
<listitem>
<para>
Take advantage of versioning and scoping
provided by Solaris 2.x and Linux. PHP 3 only!
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc/en/appendices/configure/php.xml?r=1.1&p=1
Index: phpdoc/en/appendices/configure/php.xml
+++ phpdoc/en/appendices/configure/php.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect3 id="configure.options.php">
<title>PHP options</title>
<variablelist>
<varlistentry id="configure.enable-maintainer-mode">
<term>
<option role="configure">--enable-maintainer-mode</option>
</term>
<listitem>
<para>
Enable make rules and dependencies not useful (and sometimes confusing)
to the casual installer.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-config-file-path">
<term>
<option role="configure">--with-config-file-path=PATH</option>
</term>
<listitem>
<para>
Sets the path in which to look for &php.ini;, defaults to PREFIX/lib.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-safe-mode">
<term>
<option role="configure">--enable-safe-mode</option>
</term>
<listitem>
<para>
Enable safe mode by default.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-exec-dir">
<term>
<option role="configure">--with-exec-dir[=DIR]</option>
</term>
<listitem>
<para>
Only allow executables in DIR when in safe mode defaults to /usr/local/php/bin.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-magic-quotes">
<term>
<option role="configure">--enable-magic-quotes</option>
</term>
<listitem>
<para>
Enable magic quotes by default.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-short-tags">
<term>
<option role="configure">--disable-short-tags</option>
</term>
<listitem>
<para>
Disable the short-form <? start tag by default.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
http://cvs.php.net/co.php/phpdoc/en/appendices/configure/servers.xml?r=1.1&p=1
Index: phpdoc/en/appendices/configure/servers.xml
+++ phpdoc/en/appendices/configure/servers.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<sect3 id="configure.options.servers">
<title>SAPI options</title>
<para>
The following list contains the available SAPI&s (<literal>Server
Application Programming Interface)</literal> for PHP.
</para>
<variablelist>
<varlistentry id="configure.with-aolserver">
<term>
<option role="configure">--with-aolserver=DIR</option>
</term>
<listitem>
<para>
Specify path to the installed AOLserver.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-apxs">
<term>
<option role="configure">--with-apxs[=FILE]</option>
</term>
<listitem>
<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.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-apache">
<term>
<option role="configure">--with-apache[=DIR]</option>
</term>
<listitem>
<para>
Build a static Apache module. DIR is the top-level Apache build directory,
defaults to <filename>/usr/local/apache</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-mod_charset">
<term>
<option role="configure">--with-mod_charset</option>
</term>
<listitem>
<para>
Enable transfer tables for mod_charset (Russian Apache).
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-apxs2">
<term>
<option role="configure">--with-apxs2[=FILE]</option>
</term>
<listitem>
<para>
Build shared Apache 2.0 module. FILE is the optional pathname to the Apache
apxs tool; defaults to apxs.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-caudium">
<term>
<option role="configure">--with-caudium=DIR</option>
</term>
<listitem>
<para>
Build PHP as a Pike module for use with Caudium. DIR is the Caudium server
dir, with the default value <filename>/usr/local/caudium/server</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-cli">
<term>
<option role="configure">--disable-cli</option>
</term>
<listitem>
<para>
Available with PHP 4.3.0. Disable building the CLI version of PHP (this
forces <link linkend="configure.without-pear">--without-pear</link>).
More information is available in the section about
<link linkend="features.commandline">Using PHP from the command line</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-embed">
<term>
<option role="configure">--enable-embed[=TYPE]</option>
</term>
<listitem>
<para>
Enable building of the embedded SAPI library. TYPE is either
<literal>shared</literal> or <literal>static</literal>, which
defaults to <literal>shared</literal>. Available with PHP 4.3.0.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-fhttpd">
<term>
<option role="configure">--with-fhttpd[=DIR]</option>
</term>
<listitem>
<para>
Build fhttpd module. DIR is the fhttpd sources directory, defaults to
<filename>/usr/local/src/fhttpd</filename>. No longer available as of PHP
4.3.0.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-isapi">
<term>
<option role="configure">--with-isapi=DIR</option>
</term>
<listitem>
<para>
Build PHP as an ISAPI module for use with Zeus.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-nsapi">
<term>
<option role="configure">--with-nsapi=DIR</option>
</term>
<listitem>
<para>
Specify path to the installed Netscape/iPlanet/SunONE Webserver.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-phttpd">
<term>
<option role="configure">--with-phttpd=DIR</option>
</term>
<listitem>
<para>
No information yet.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-pi3web">
<term>
<option role="configure">--with-pi3web=DIR</option>
</term>
<listitem>
<para>
Build PHP as a module for use with Pi3Web.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-roxen">
<term>
<option role="configure">--with-roxen=DIR</option>
</term>
<listitem>
<para>
Build PHP as a Pike module. DIR is the base Roxen directory, normally
<filename>/usr/local/roxen/server</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-roxen-zts">
<term>
<option role="configure">--enable-roxen-zts</option>
</term>
<listitem>
<para>
Build the Roxen module using Zend Thread Safety.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-servlet">
<term>
<option role="configure">--with-servlet[=DIR]</option>
</term>
<listitem>
<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.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-thttpd">
<term>
<option role="configure">--with-thttpd=SRCDIR</option>
</term>
<listitem>
<para>
Build PHP as thttpd module.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-tux">
<term>
<option role="configure">--with-tux=MODULEDIR</option>
</term>
<listitem>
<para>
Build PHP as a TUX module (Linux only).
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-webjames">
<term>
<option role="configure">--with-webjames=SRCDIR</option>
</term>
<listitem>
<para>
Build PHP as a WebJames module (RISC OS only)
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-cgi">
<term>
<option role="configure">--disable-cgi</option>
</term>
<listitem>
<para>
Disable building CGI version of PHP. Available with PHP 4.3.0.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-force-cgi-redirect">
<term>
<option role="configure">--enable-force-cgi-redirect</option>
</term>
<listitem>
<para>
Enable the security check for internal server redirects. You should use
this if you are running the CGI version with Apache.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-discard-path">
<term>
<option role="configure">--enable-discard-path</option>
</term>
<listitem>
<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 &htaccess;
security.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.with-fastcgi">
<term>
<option role="configure">--with-fastcgi</option>
</term>
<listitem>
<para>
Build PHP as FastCGI application. No longer available as of PHP 4.3.0,
instead you should use <option role="configure">--enable-fastcgi</option>.
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.enable-fastcgi">
<term>
<option role="configure">--enable-fastcgi</option>
</term>
<listitem>
<para>
If this is enabled, the CGI module will be built with support for FastCGI
also. Available since PHP 4.3.0
</para>
</listitem>
</varlistentry>
<varlistentry id="configure.disable-path-info-check">
<term>
<option role="configure">--disable-path-info-check</option>
</term>
<listitem>
<para>
If this is disabled, paths such as <filename>/info.php/test?a=b</filename>
will fail to work. Available since <literal>PHP 4.3.0</literal>.
For more information see the
<ulink url="&url.apache.core;acceptpathinfo">Apache Manual</ulink>.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
