jmoore Fri Jan 26 08:48:53 2001 EDT
Modified files:
/phpdoc global.ent
/phpdoc/en/chapters install.xml
Log:
Correcting Goba's english and some (infact lots) of whitespace changes
Index: phpdoc/global.ent
diff -u phpdoc/global.ent:1.69 phpdoc/global.ent:1.70
--- phpdoc/global.ent:1.69 Tue Jan 16 17:55:30 2001
+++ phpdoc/global.ent Fri Jan 26 08:48:52 2001
@@ -1,6 +1,6 @@
<!-- -*- SGML -*-
- $Id: global.ent,v 1.69 2001/01/17 01:55:30 jimw Exp $
+ $Id: global.ent,v 1.70 2001/01/26 16:48:52 jmoore Exp $
Contains global "macros" for all the SGML documents.
@@ -67,7 +67,7 @@
<!ENTITY url.mersenne "http://www.math.keio.ac.jp/~matumoto/emt.html">
<!ENTITY url.mersenne.twister "http://www.scp.syr.edu/~marc/hawk/twister.html">
<!ENTITY url.mhash "http://mhash.sourceforge.net/">
-<!ENTITY url.ovrimos "http://www.ovrimos.com/">
+<!ENTITY url.mirrors "http://www.php.net/mirrors.php">
<!ENTITY url.msql "http://www.hughes.com.au/">
<!ENTITY url.mysql "http://www.mysql.com/">
<!ENTITY url.mysql.docs "http://www.mysql.com/documentation/">
@@ -79,6 +79,7 @@
<!ENTITY url.openlink "http://www.openlinksw.com/">
<!ENTITY url.openssl "http://www.openssl.org/">
<!ENTITY url.oracle "http://www.oracle.com/">
+<!ENTITY url.ovrimos "http://www.ovrimos.com/">
<!ENTITY url.psgml "ftp://ftp.lysator.liu.se/pub/sgml/psgml-1.0.1.tar.gz">
<!ENTITY url.pdf "http://www.pdflib.com/pdflib/index.html">
<!ENTITY url.pfpro "http://www.verisign.com/payment/">
Index: phpdoc/en/chapters/install.xml
diff -u phpdoc/en/chapters/install.xml:1.36 phpdoc/en/chapters/install.xml:1.37
--- phpdoc/en/chapters/install.xml:1.36 Fri Jan 26 06:43:17 2001
+++ phpdoc/en/chapters/install.xml Fri Jan 26 08:48:52 2001
@@ -7,8 +7,8 @@
The source code, and binary distributions for some platforms
(including Windows), can be found at <literal><ulink
url="&url.php;">&url.php;</ulink></literal>. We recommend
- you to choose a near mirror site of php.net for downloading.
- You can find one with the dropdown menu on every page.
+ you to choose <ulink url="&url.mirrors">mirror</ulink> nearest
+ to you for downloading the distrobutions.
</simpara>
</sect1>
@@ -60,14 +60,13 @@
<para>
There are several ways to install PHP for the Unix platform, either
with a compile and configure process, or through various
- pre-packaged methods. The user compile and configuration processes
- are much more complex, so the documentation is more focused on those
- procedures.
+ pre-packaged methods. This documentation is mainly focused around
+ the process of compiling and configuring PHP.
</para>
<para>
The initial PHP setup and configuration process is controlled by the
- use of commandline options to the <filename>configure</filename>
+ use of the commandline options of the <filename>configure</filename>
script. This page outlines the usage of the most common options,
but there are many others to play with. Check out the <link
linkend="install.configure">Complete list of configure
@@ -142,8 +141,8 @@
<sect2 id="install.building">
<title>Building</title>
<simpara>
- When PHP is configured, you are ready to build the CGI executable
- or the PHP library. The command <command>make</command> should
+ When PHP is configured, you are ready to build the CGI executable.
+ The command <command>make</command> should
take care of this. If it fails and you can't figure out why, see
the <link linkend="install-problems">Problems section</link>.
</simpara>
@@ -160,12 +159,12 @@
<title>Using Packages</title>
<simpara>
Many Linux distributions have some sort of package installation,
- such as RPM. This can greatly assist in setting up a standard
+ such as RPM. This can assist in setting up a standard
configuration, but if you need to have a different set of features
(such as a secure server, or a different database driver), you may
need to build php and/or your webserver. If you are unfamiliar
with building and compiling your own software, it is worth
- investigating whether or not somebody has already built a packaged
+ checking to see whether somebody has already built a packaged
version of PHP with the features you need.
</simpara>
</sect2>
@@ -255,116 +254,113 @@
</sect1>
<sect1 id="install.solaris">
-<title>Solaris installs</title>
-<para>
- This section contains notes and hints specific to installing
- PHP on Solaris systems.
-</para>
-<sect2 id="install.solaris.required">
- <title>Required software</title>
+ <title>Solaris installs</title>
<para>
- Solaris installs often lack C compilers and their related tools.
- The required software is as follows:
- <itemizedlist>
- <listitem>
- <simpara>
- gcc (recommended, other C compilers may work)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- make
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- flex
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- bison
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- m4
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- autoconf
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- automake
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- perl
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- gzip
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- tar
- </simpara>
- </listitem>
- </itemizedlist>
- In addition, you will need to install (and possibly compile) any
- additional software specific to your configuration (such as Oracle
- or MySQL.
- </para>
- </sect2>
-
- <sect2 id="install.solaris.packages">
- <title>Using Packages</title>
- <simpara>
- You can simplify the Solaris install process by using pkgadd to
- install most of your needed components.
- </simpara>
- </sect2>
- </sect1>
+ This section contains notes and hints specific to installing
+ PHP on Solaris systems.
+ </para>
+ <sect2 id="install.solaris.required">
+ <title>Required software</title>
+ <para>
+ Solaris installs often lack C compilers and their related tools.
+ The required software is as follows:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ gcc (recommended, other C compilers may work)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ make
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ flex
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ bison
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ m4
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ autoconf
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ automake
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ perl
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ gzip
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ tar
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ In addition, you will need to install (and possibly compile) any
+ additional software specific to your configuration (such as Oracle
+ or MySQL.
+ </para>
+ </sect2>
+ <sect2 id="install.solaris.packages">
+ <title>Using Packages</title>
+ <simpara>
+ You can simplify the Solaris install process by using pkgadd to
+ install most of your needed components.
+ </simpara>
+ </sect2>
+</sect1>
- <sect1 id="install.macosx">
- <title>Mac OS X installs</title>
- <para>
- This section contains notes and hints specific to installing
- PHP on Mac OS X.
- </para>
- <sect2 id="install.macosx.packages">
- <title>Using Packages</title>
- <simpara>
- There are a few pre-packaged and pre-compiled versions of PHP for
- Mac OS X. This can greatly assist in setting up a standard
- configuration, but if you need to have a different set of features
- (such as a secure server, or a different database driver), you may
- need to build PHP and/or your web server yourself. If you are unfamiliar
- with building and compiling your own software, it's worth
- investigating whether or not somebody has already built a packaged
- version of PHP with the features you need.
- <ulink url="&url.lightyear;">Lightyear Design</ulink> offers a
- pre-built version of PHP for OS X, as does
- <ulink url="&url.tenon;">Tenon Intersystems</ulink>.
- </simpara>
- </sect2>
- <sect2 id="install.macosx.compile">
- <title>Compiling for OS X server</title>
- <simpara>
- There are two slightly different versions of Mac OS X, client and
- server. The following is for OS X Server.
- </simpara>
- <example id="install.macosx.compile.example">
- <title>
- Mac OS X server install
- </title>
- <programlisting>
+<sect1 id="install.macosx">
+ <title>Mac OS X installs</title>
+ <para>
+ This section contains notes and hints specific to installing
+ PHP on Mac OS X.
+ </para>
+ <sect2 id="install.macosx.packages">
+ <title>Using Packages</title>
+ <simpara>
+ There are a few pre-packaged and pre-compiled versions of PHP for
+ Mac OS X. This can help in setting up a standard
+ configuration, but if you need to have a different set of features
+ (such as a secure server, or a different database driver), you may
+ need to build PHP and/or your web server yourself. If you are unfamiliar
+ with building and compiling your own software, it's worth
+ checking whether somebody has already built a packaged
+ version of PHP with the features you need.
+ <ulink url="&url.lightyear;">Lightyear Design</ulink> offers a
+ pre-built version of PHP for OS X, as does
+ <ulink url="&url.tenon;">Tenon Intersystems</ulink>.
+ </simpara>
+ </sect2>
+ <sect2 id="install.macosx.compile">
+ <title>Compiling for OS X server</title>
+ <simpara>
+ There are two slightly different versions of Mac OS X, client and
+ server. The following is for OS X Server.
+ </simpara>
+ <example id="install.macosx.compile.example">
+ <title>Mac OS X server install</title>
+ <programlisting>
1. Get the latest distributions of Apache and PHP
2. Untar them, and run the configure program on Apache like so.
./configure --exec-prefix=/usr \
@@ -420,6 +416,7 @@
date.
9. make
+
10. make install
11. copy and rename the php.ini-dist file to your "bin" directory from your
@@ -429,1354 +426,1275 @@
or (if your don't have a local directory)
cp php.ini-dist /usr/bin/php.ini
- </programlisting>
- </example>
+ </programlisting>
+ </example>
- <simpara>
- Other examples for
- <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink>
- and
- <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink>
- are available at <ulink url="&url.stepwise;">Stepwise</ulink>.
- </simpara>
- </sect2>
- </sect1>
+ <simpara>
+ Other examples for
+ <ulink url="&url.stepwise.macosx-client;">Mac OS X client</ulink>
+ and
+ <ulink url="&url.stepwise.macosx-client;">Mac OS X server</ulink>
+ are available at <ulink url="&url.stepwise;">Stepwise</ulink>.
+ </simpara>
+ </sect2>
+</sect1>
- <sect1 id="install.configure">
- <title>Complete list of configure options</title>
+<sect1 id="install.configure">
+ <title>Complete list of configure options</title>
+ <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">Configuration</link>.
+ </para>
+ </note>
- <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">Configuration</link>.
- </para>
- </note>
+ <para>
+ The following is a complete list of options supported by the PHP 3
+ and PHP 4 <filename>configure</filename> scripts, used when
+ compiling in Unix-like environments. Some are available in PHP 3,
+ some in PHP 4, and some in both, as noted. There are many options
+ the names of which have changed between PHP 3 and PHP 4, but which
+ accomplish the same things. These entries are cross-referenced to
+ each other, so if you have a problem getting your PHP 3-era
+ configuration options to work, check here to see whether the names
+ have changed.
+ </para>
+ <itemizedlist>
+ <listitem>
<para>
- The following is a complete list of options supported by the PHP 3
- and PHP 4 <filename>configure</filename> scripts, used when
- compiling in Unix-like environments. Some are available in PHP 3,
- some in PHP 4, and some in both, as noted. There are many options
- the names of which have changed between PHP 3 and PHP 4, but which
- accomplish the same things. These entries are cross-referenced to
- each other, so if you have a problem getting your PHP 3-era
- configuration options to work, check here to see whether the names
- have changed.
+ <link linkend="install.configure.databases">Database</link>
</para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.ecommerce">Ecommerce</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.graphics">Graphics</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.misc">Miscellaneous</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.networking">Networking</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.php">PHP Behaviour</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.servers">Server</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.text">Text and language</link>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <link linkend="install.configure.xml">XML</link>
+ </para>
+ </listitem>
+ </itemizedlist>
- <itemizedlist>
- <listitem>
- <para>
- <link linkend="install.configure.databases">Database</link>
+ <sect2 id="install.configure.databases">
+ <title>Database</title>
+ <variablelist>
+
+ <varlistentry id="install.configure.with-adabas">
+ <term>
+ <parameter>--with-adabas[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Adabas D support. DIR is the Adabas base
+ install directory, defaults to /usr/local.
+ </para>
+ <para>
+ <ulink url="&url.adabas;">Adabas home page</ulink>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-dba">
+ <term>
+ <parameter>--enable-dba=shared</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Build DBA as a shared module
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-dbase">
+ <term>
+ <parameter>--enable-dbase</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available; use <link
+ linkend="install.configure.with-dbase">--with-dbase</link>
+ instead.
+ </para>
+ <para>
+ PHP 4: Enable the bundled dbase library. No external libraries
+ are required.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-dbase">
+ <term>
+ <parameter>--with-dbase</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include the bundled dbase library. No external
+ libraries are required.
+ </para>
+ <para>
+ PHP 4: Option not available; use <link
+ linkend="install.configure.enable-dbase">--enable-dbase</link>
+ instead.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-db2">
+ <term>
+ <parameter>--with-db2[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Berkeley DB2 support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-db3">
+ <term>
+ <parameter>--with-db3[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include Berkeley DB3 support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-dbm">
+ <term>
+ <parameter>--with-dbm[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include DBM support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-dbmaker">
+ <term>
+ <parameter>--with-dbmaker[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include DBMaker support. DIR is the DBMaker base install
+ directory, defaults to where the latest version of DBMaker is installed
+ (such as /home/dbmaker/3.6).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-empress">
+ <term>
+ <parameter>--with-empress[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Empress support. DIR is the Empress base install
+ directory, defaults to $EMPRESSPATH
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-filepro">
+ <term>
+ <parameter>--enable-filepro</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available; use <link
+ linkend="install.configure.with-filepro">--with-filepro</link>
+ instead.
+ </para>
+ <para>
+ PHP 4: Enable the bundled read-only filePro support. No
+ external libraries are required.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-filepro">
+ <term>
+ <parameter>--with-filepro</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include the bundled read-only filePro support. No
+ external libraries are required.
+ </para>
+ <para>
+ PHP 4: Option not available; use <link
+ linkend="install.configure.enable-filepro">--enable-filepro</link>
+ instead.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-gdbm">
+ <term>
+ <parameter>--with-gdbm[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include GDBM support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-hyperwave">
+ <term>
+ <parameter>--with-hyperwave</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Hyperwave support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-ibm-db2">
+ <term>
+ <parameter>--with-ibm-db2[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include IBM DB2 support. DIR is the DB2 base
+ install directory, defaults to
+ <filename>/home/db2inst1/sqllib</filename>.
+ </para>
+ <para>
+ <ulink url="&url.ibmdb2;">IBM DB2 home page</ulink>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-informix">
+ <term>
+ <parameter>--with-informix[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Informix support. DIR is the Informix base install
+ directory, defaults to nothing.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-ingres">
+ <term>
+ <parameter>--with-ingres[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include Ingres II support. DIR is the Ingres base directory
+ (default /II/ingres)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-interbase">
+ <term>
+ <parameter>--with-interbase[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include InterBase support. DIR is the InterBase base
+ install directory, which defaults to <filename>/usr/interbase</filename>.
+ </para>
+ <simpara>
+ <link linkend="ref.ibase">Interbase functions</link>
+ </simpara>
+ <simpara>
+ <ulink url="&url.ibase;">Interbase home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-ldap">
+ <term>
+ <parameter>--with-ldap[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include LDAP support. DIR is the LDAP base install
+ directory. Defaults to <filename>/usr</filename> and
+ <filename>/usr/local</filename>
</para>
- </listitem>
- <listitem>
<para>
- <link linkend="install.configure.ecommerce">Ecommerce</link>
+ PHP 4: Include LDAP support. DIR is the LDAP base install directory.
</para>
- </listitem>
- <listitem>
+ <simpara>
+ This provides <acronym>LDAP</acronym> (Lightweight Directory Access
+ Protocol support). The parameter is the LDAP base install
+ directory, defaults to <filename
+ class="directory">/usr/local/ldap</filename>.
+ </simpara>
+ <simpara>
+ More information about LDAP can be found in <ulink
+ url="&url.rfc;rfc1777.html">RFC1777</ulink> and
+ <ulink
+ url="&url.rfc;rfc1778.html">RFC1778</ulink>.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-msql">
+ <term>
+ <parameter>--with-msql[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Enables mSQL support. The parameter to this
+ option is the mSQL install directory and defaults to <filename
+ class="directory">/usr/local/Hughes</filename>. This is the
+ default directory of the mSQL 2.0 distribution.
+ <command>configure</command> automatically detects which mSQL
+ version you are running and PHP supports both 1.0 and 2.0, but
+ if you compile PHP with mSQL 1.0, you can only access mSQL 1.0
+ databases, and vice-versa.
+ </para>
+ <simpara>
+ See also <link linkend="ini.sect.msql">mSQL
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration file</link>.
+ </simpara>
+ <simpara>
+ <ulink url="&url.msql;">mSQL home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-mysql">
+ <term>
+ <parameter>--with-mysql[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include MySQL support. DIR is the MySQL base install directory,
+ defaults to searching through a number of common places for the MySQL
+ files.
+ </para>
+ <para>
+ PHP 4: Include MySQL support. DIR is the MySQL base directory. If
+ unspecified, the bundled MySQL library will be used. This
+ option is turned on by default.
+ </para>
+ <para>
+ See also <link linkend="ini.sect.mysql">MySQL
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration file</link>.
+ </para>
+ <para>
+ <ulink url="&url.mysql;">MySQL home page</ulink>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-ndbm">
+ <term>
+ <parameter>--with-ndbm[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include NDBM support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-oci8">
+ <term>
+ <parameter>--with-oci8[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include Oracle-oci8 support. Default DIR is ORACLE_HOME.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-oracle">
+ <term>
+ <parameter>--with-oracle[=DIR]</parameter>
+ </term>
+ <listitem>
<para>
- <link linkend="install.configure.graphics">Graphics</link>
+ PHP 3: Include Oracle database support. DIR is Oracle's home directory,
+ defaults to $ORACLE_HOME.
</para>
- </listitem>
- <listitem>
<para>
- <link linkend="install.configure.misc">Miscellaneous</link>
+ PHP 4: Include Oracle-oci7 support. Default DIR is ORACLE_HOME.
</para>
+ <simpara>
+ Includes Oracle support. Has been tested and should be
+ working at least with Oracle versions 7.0 through 7.3. The
+ parameter is the <envar>ORACLE_HOME</envar> directory. You do
+ not have to specify this parameter if your Oracle environment
+ has been set up.
+ </simpara>
+ <simpara>
+ <ulink url="&url.oracle;">Oracle home page</ulink>
+ </simpara>
</listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-pgsql">
+ <term>
+ <parameter>--with-pgsql[=DIR]</parameter>
+ </term>
<listitem>
<para>
- <link linkend="install.configure.networking">Networking</link>
+ PHP 3: Include PostgresSQL support. DIR is the PostgresSQL base
+ install directory, which defaults to
+ <filename>/usr/local/pgsql</filename>.
</para>
- </listitem>
- <listitem>
<para>
- <link linkend="install.configure.php">PHP Behaviour</link>
+ PHP 4: Include PostgreSQL support. DIR is the PostgreSQL base
+ install directory, which defaults to
+ <filename>/usr/local/pgsql</filename>. Set DIR to shared to
+ build as a dl, or shared,DIR to build as a dl and still specify
+ DIR.
</para>
- </listitem>
+ <simpara>
+ See also <link linkend="ini.sect.pgsql">Postgres
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration file</link>.
+ </simpara>
+ <simpara>
+ <ulink url="&url.pgsql;">PostgreSQL home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-solid">
+ <term>
+ <parameter>--with-solid[=DIR]</parameter>
+ </term>
<listitem>
<para>
- <link linkend="install.configure.servers">Server</link>
+ PHP 3, PHP 4: Include Solid support. DIR is the Solid base install
+ directory, defaults to /usr/local/solid
</para>
+ <simpara>
+ <ulink url="&url.solid;">Solid home page</ulink>
+ </simpara>
</listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-sybase-ct">
+ <term>
+ <parameter>--with-sybase-ct[=DIR]</parameter>
+ </term>
<listitem>
<para>
- <link linkend="install.configure.text">Text and language</link>
+ PHP 3, PHP 4: Include Sybase-CT support. DIR is the Sybase home
+ directory, defaults to /home/sybase.
</para>
+ <simpara>
+ See also <link linkend="ini.sect.sybct">Sybase-CT
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration
+ file</link>.
+ </simpara>
</listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-sybase">
+ <term>
+ <parameter>--with-sybase[=DIR]</parameter>
+ </term>
<listitem>
<para>
- <link linkend="install.configure.xml">XML</link>
+ PHP 3, PHP 4: Include Sybase-DB support. DIR is the Sybase home
+ directory, which defaults to <filename>/home/sybase</filename>.
</para>
+ <simpara>
+ See also <link linkend="ini.sect.sybase">Sybase
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration file</link>.
+ </simpara>
+ <simpara>
+ <ulink url="&url.sybase;">Sybase home page</ulink>
+ </simpara>
</listitem>
- </itemizedlist>
-
- <sect2 id="install.configure.databases">
- <title>Database</title>
-
- <variablelist>
- <varlistentry id="install.configure.with-adabas">
- <term>
- <parameter>--with-adabas[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Adabas D support. DIR is the Adabas base
- install directory, defaults to /usr/local.
- </para>
- <para>
- <ulink url="&url.adabas;">Adabas home page</ulink>
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-dba">
- <term>
- <parameter>--enable-dba=shared</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Build DBA as a shared module
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-dbase">
- <term>
- <parameter>--enable-dbase</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available; use <link
- linkend="install.configure.with-dbase">--with-dbase</link>
- instead.
- </para>
- <para>
- PHP 4: Enable the bundled dbase library. No external libraries
- are required.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-dbase">
- <term>
- <parameter>--with-dbase</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include the bundled dbase library. No external
- libraries are required.
- </para>
- <para>
- PHP 4: Option not available; use <link
- linkend="install.configure.enable-dbase">--enable-dbase</link>
- instead.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-db2">
- <term>
- <parameter>--with-db2[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Berkeley DB2 support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-db3">
- <term>
- <parameter>--with-db3[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include Berkeley DB3 support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-dbm">
+ </varlistentry>
+ <varlistentry id="install.configure.with-openlink">
+ <term>
+ <parameter>--with-openlink[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include OpenLink ODBC support. DIR is the OpenLink base
+ install directory, defaults to /usr/local/openlink.
+ </para>
+ <simpara>
+ <ulink url="&url.openlink;">OpenLink Software's home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-iodbc">
+ <term>
+ <parameter>--with-iodbc[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include iODBC support. DIR is the iODBC base install
+ directory, defaults to <filename>/usr/local</filename>.
+ </para>
+ <para>
+ This feature was first developed for iODBC Driver Manager, a
+ freely redistributable ODBC driver manager which runs under
+ many flavors of UNIX.
+ </para>
+ <simpara>
+ <ulink url="&url.freeodbc;">FreeODBC home page</ulink>
+ or <ulink url="&url.iodbc;">iODBC home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-custom-odbc">
+ <term>
+ <parameter>--with-custom-odbc[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Includes support for an arbitrary custom ODBC
+ library. The parameter is the base directory and defaults to
+ <filename class="directory">/usr/local</filename>.
+ </para>
+ <simpara>
+ This option implies that you have defined CUSTOM_ODBC_LIBS
+ when you run the configure script. You also must have a valid
+ odbc.h header somewhere in your include path. If you don't
+ have one, create it and include your specific header from
+ there. Your header may also require some extra definitions,
+ particularly when it is multiplatform. Define them in
+ CFLAGS.
+ </simpara>
+ <simpara>
+ For example, you can use Sybase SQL Anywhere on QNX as
+ following:
+ <literal>
+ CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib
+ -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50
+ </literal>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-unified-odbc">
+ <term>
+ <parameter>--disable-unified-odbc</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Disable unified ODBC support. Only applicable if iODBC, Adabas,
+ Solid, Velocis or a custom ODBC interface is enabled.
+ </para>
+ <para>
+ PHP 4: Option not available in PHP 4
+ </para>
+ <simpara>
+ The Unified ODBC module, which is a common interface to all
+ the databases with ODBC-based interfaces, such as Solid, IBM
+ DB2 and Adabas D. It also works for normal ODBC libraries.
+ Has been tested with iODBC, Solid, Adabas D, IBM DB2 and
+ Sybase SQL Anywhere. Requires that one (and only one) of these
+ extensions or the Velocis extension is enabled, or a custom ODBC
+ library specified. This option is only applicable if one of
+ the following options is used: <link
+ linkend="install.configure.with-iodbc">--with-iodbc</link>,
+ <link
+ linkend="install.configure.with-solid">--with-solid</link>,
+ <link
+ linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>,
+ <link
+ linkend="install.configure.with-adabas">--with-adabas</link>,
+ <link
+ linkend="install.configure.with-velocis">--with-velocis</link>,
+ or <link
+ linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>.
+ </simpara>
+ <simpara>
+ See also <link linkend="ini.sect.uodbc">Unified ODBC
+ Configuration</link> Directives in the <link
+ linkend="configuration.file">configuration
+ file</link>.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-unixODBC">
+ <term>
+ <parameter>--with-unixODBC[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include unixODBC support. DIR is the unixODBC base install
+ directory, defaults to /usr/local.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-velocis">
+ <term>
+ <parameter>--with-velocis[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include Velocis support. DIR is the Velocis base install
+ directory, defaults to /usr/local/velocis.
+ </para>
+ <simpara>
+ <ulink url="&url.velocis;">Velocis home page</ulink>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="install.configure.ecommerce">
+ <title>Ecommerce</title>
+ <variablelist>
+ <varlistentry id="install.configure.with-ccvs">
+ <term>
+ <parameter>--with-ccvs[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Compile CCVS support into PHP 4. Please specify your CCVS base
+ install directory as DIR.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-mck">
+ <term>
+ <parameter>--with-mck[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include Cybercash MCK support. DIR is the cybercash mck
+ build directory, which defaults to
+ <filename>/usr/src/mck-3.2.0.3-linux</filename>. For help, look
+ in <filename>extra/cyberlib</filename>.
+ </para>
+ <para>
+ PHP 4: Option not available; use <link
+ linkend="install.configure.with-cybercash">--with-cybercash</link>
+ instead.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-cybercash">
+ <term>
+ <parameter>--with-cybercash[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available; use <link
+ linkend="install.configure.with-mck">--with-mck</link>
+ instead.
+ </para>
+ <para>
+ PHP 4: Include CyberCash support. DIR is the CyberCash MCK install
+ directory.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-pfpro">
<term>
- <parameter>--with-dbm[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include DBM support
- </para>
- </listitem>
- </varlistentry>
+ <parameter>--with-pfpro[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include Verisign Payflow Pro support
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="install.configure.graphics">
+ <title>Graphics</title>
+ <variablelist>
+ <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack">
+ <term>
+ <parameter>--enable-freetype-4bit-antialias-hack</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Include support for FreeType2 (experimental).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-gd">
+ <term>
+ <parameter>--with-gd[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include GD support (DIR is GD's install dir).
+ </para>
+ <para>
+ PHP 4: Include GD support (DIR is GD's install dir). Set DIR to shared
+ to build as a dl, or shared,DIR to build as a dl and still specify DIR.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.without-gd">
+ <term>
+ <parameter>--without-gd</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Disable GD support.
+ </para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="install.configure.with-dbmaker">
- <term>
- <parameter>--with-dbmaker[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include DBMaker support. DIR is the DBMaker base install
- directory, defaults to where the latest version of DBMaker is installed
- (such as /home/dbmaker/3.6).
- </para>
- </listitem>
- </varlistentry>
+ <varlistentry id="install.configure.with-imagick">
+ <term>
+ <parameter>--with-imagick[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Include ImageMagick support. DIR is the install
+ directory, and if left out, PHP will try to find it on its
+ own. [experimental]
+ </para>
+ <para>
+ PHP 4: Option not available in PHP 4
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-jpeg-dir">
+ <term>
+ <parameter>--with-jpeg-dir[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: jpeg dir for pdflib 2.0
+ </para>
+ <para>
+ PHP 4: jpeg dir for pdflib 3.x
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-png-dir">
+ <term>
+ <parameter>--with-png-dir[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: png dir for pdflib 3.x
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-t1lib">
+ <term>
+ <parameter>--enable-t1lib</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Enable t1lib support.
+ </para>
+ <para>
+ PHP 4: Option not available; use <link
+ linkend="install.configure.with-t1lib">--with-t1lib</link>
+ instead.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-t1lib">
+ <term>
+ <parameter>--with-t1lib[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available; use <link
+ linkend="install.configure.enable-t1lib">--enable-t1lib</link>
+ instead.
+ </para>
+ <para>
+ PHP 4: Include T1lib support.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-tiff-dir">
+ <term>
+ <parameter>--with-tiff-dir[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: tiff dir for pdflib 2.0
+ </para>
+ <para>
+ PHP 4: tiff dir for pdflib 3.x
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-ttf">
+ <term>
+ <parameter>--with-ttf[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Include FreeType support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.with-xpm-dir">
+ <term>
+ <parameter>--with-xpm-dir[=DIR]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: xpm dir for gd-1.8+
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
- <varlistentry id="install.configure.with-empress">
- <term>
- <parameter>--with-empress[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Empress support. DIR is the Empress base install
- directory, defaults to $EMPRESSPATH
- </para>
- </listitem>
- </varlistentry>
+ <sect2 id="install.configure.misc">
+ <title>Miscellaneous</title>
+ <para>
+ These are being classified over time, where appropriate.
+ </para>
+ <variablelist>
+ <varlistentry id="install.configure.disable-bcmath">
+ <term>
+ <parameter>--disable-bcmath</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Compile without BC arbitrary precision math
+ functions. These functions allow you to operate with numbers
+ outside of the ranges allowed by regular integers and floats;
+ see <link linkend="ref.bc">BCMath Arbitrary Precision
+ Mathematics Functions</link> for more information.
+ </para>
+ <para>
+ PHP 4: Option not available; bcmath is not compiled in by
+ default. Use <link
+ linkend="install.configure.enable-bcmath">--enable-bcmath</link>
+ to compile it in.
+ </para>
+ </listitem>
+ </varlistentry>
- <varlistentry id="install.configure.enable-filepro">
- <term>
- <parameter>--enable-filepro</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available; use <link
- linkend="install.configure.with-filepro">--with-filepro</link>
- instead.
- </para>
- <para>
- PHP 4: Enable the bundled read-only filePro support. No
- external libraries are required.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-filepro">
- <term>
- <parameter>--with-filepro</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include the bundled read-only filePro support. No
- external libraries are required.
- </para>
- <para>
- PHP 4: Option not available; use <link
- linkend="install.configure.enable-filepro">--enable-filepro</link>
- instead.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-gdbm">
- <term>
- <parameter>--with-gdbm[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include GDBM support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-hyperwave">
- <term>
- <parameter>--with-hyperwave</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Hyperwave support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-ibm-db2">
- <term>
- <parameter>--with-ibm-db2[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include IBM DB2 support. DIR is the DB2 base
- install directory, defaults to
- <filename>/home/db2inst1/sqllib</filename>.
- </para>
- <para>
- <ulink url="&url.ibmdb2;">IBM DB2 home page</ulink>
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-informix">
- <term>
- <parameter>--with-informix[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Informix support. DIR is the Informix base install
- directory, defaults to nothing.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-ingres">
- <term>
- <parameter>--with-ingres[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include Ingres II support. DIR is the Ingres base directory
- (default /II/ingres)
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-interbase">
- <term>
- <parameter>--with-interbase[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include InterBase support. DIR is the InterBase base
- install directory, which defaults to <filename>/usr/interbase</filename>.
- </para>
- <simpara>
- <link linkend="ref.ibase">Interbase functions</link>
- </simpara>
- <simpara>
- <ulink url="&url.ibase;">Interbase home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-ldap">
- <term>
- <parameter>--with-ldap[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include LDAP support. DIR is the LDAP base install
- directory. Defaults to <filename>/usr</filename> and
- <filename>/usr/local</filename>
- </para>
- <para>
- PHP 4: Include LDAP support. DIR is the LDAP base install directory.
- </para>
- <simpara>
- This provides <acronym>LDAP</acronym> (Lightweight Directory Access
- Protocol support). The parameter is the LDAP base install
- directory, defaults to <filename
- class="directory">/usr/local/ldap</filename>.
- </simpara>
- <simpara>
- More information about LDAP can be found in <ulink
- url="&url.rfc;rfc1777.html">RFC1777</ulink> and
- <ulink
- url="&url.rfc;rfc1778.html">RFC1778</ulink>.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-msql">
- <term>
- <parameter>--with-msql[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enables mSQL support. The parameter to this
- option is the mSQL install directory and defaults to <filename
- class="directory">/usr/local/Hughes</filename>. This is the
- default directory of the mSQL 2.0 distribution.
- <command>configure</command> automatically detects which mSQL
- version you are running and PHP supports both 1.0 and 2.0, but
- if you compile PHP with mSQL 1.0, you can only access mSQL 1.0
- databases, and vice-versa.
- </para>
- <simpara>
- See also <link linkend="ini.sect.msql">mSQL
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration file</link>.
- </simpara>
- <simpara>
- <ulink url="&url.msql;">mSQL home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-mysql">
- <term>
- <parameter>--with-mysql[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include MySQL support. DIR is the MySQL base install directory,
- defaults to searching through a number of common places for the MySQL
- files.
- </para>
- <para>
- PHP 4: Include MySQL support. DIR is the MySQL base directory. If
- unspecified, the bundled MySQL library will be used. This
- option is turned on by default.
- </para>
- <para>
- See also <link linkend="ini.sect.mysql">MySQL
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration file</link>.
- </para>
- <para>
- <ulink url="&url.mysql;">MySQL home page</ulink>
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-ndbm">
- <term>
- <parameter>--with-ndbm[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include NDBM support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-oci8">
- <term>
- <parameter>--with-oci8[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include Oracle-oci8 support. Default DIR is ORACLE_HOME.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-oracle">
- <term>
- <parameter>--with-oracle[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include Oracle database support. DIR is Oracle's home directory,
- defaults to $ORACLE_HOME.
- </para>
- <para>
- PHP 4: Include Oracle-oci7 support. Default DIR is ORACLE_HOME.
- </para>
- <simpara>
- Includes Oracle support. Has been tested and should be
- working at least with Oracle versions 7.0 through 7.3. The
- parameter is the <envar>ORACLE_HOME</envar> directory. You do
- not have to specify this parameter if your Oracle environment
- has been set up.
- </simpara>
- <simpara>
- <ulink url="&url.oracle;">Oracle home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-pgsql">
- <term>
- <parameter>--with-pgsql[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include PostgresSQL support. DIR is the PostgresSQL base
- install directory, which defaults to
- <filename>/usr/local/pgsql</filename>.
- </para>
- <para>
- PHP 4: Include PostgreSQL support. DIR is the PostgreSQL base
- install directory, which defaults to
- <filename>/usr/local/pgsql</filename>. Set DIR to shared to
- build as a dl, or shared,DIR to build as a dl and still specify
- DIR.
- </para>
- <simpara>
- See also <link linkend="ini.sect.pgsql">Postgres
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration file</link>.
- </simpara>
- <simpara>
- <ulink url="&url.pgsql;">PostgreSQL home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-solid">
- <term>
- <parameter>--with-solid[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Solid support. DIR is the Solid base install
- directory, defaults to /usr/local/solid
- </para>
- <simpara>
- <ulink url="&url.solid;">Solid home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-sybase-ct">
- <term>
- <parameter>--with-sybase-ct[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Sybase-CT support. DIR is the Sybase home
- directory, defaults to /home/sybase.
- </para>
- <simpara>
- See also <link linkend="ini.sect.sybct">Sybase-CT
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration
- file</link>.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-sybase">
- <term>
- <parameter>--with-sybase[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Sybase-DB support. DIR is the Sybase home
- directory, which defaults to <filename>/home/sybase</filename>.
- </para>
- <simpara>
- See also <link linkend="ini.sect.sybase">Sybase
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration file</link>.
- </simpara>
- <simpara>
- <ulink url="&url.sybase;">Sybase home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-openlink">
- <term>
- <parameter>--with-openlink[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include OpenLink ODBC support. DIR is the OpenLink base
- install directory, defaults to /usr/local/openlink.
- </para>
- <simpara>
- <ulink url="&url.openlink;">OpenLink Software's home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-iodbc">
- <term>
- <parameter>--with-iodbc[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include iODBC support. DIR is the iODBC base install
- directory, defaults to <filename>/usr/local</filename>.
- </para>
- <para>
- This feature was first developed for iODBC Driver Manager, a
- freely redistributable ODBC driver manager which runs under
- many flavors of UNIX.
- </para>
- <simpara>
- <ulink url="&url.freeodbc;">FreeODBC home page</ulink>
- or <ulink url="&url.iodbc;">iODBC home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-custom-odbc">
- <term>
- <parameter>--with-custom-odbc[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Includes support for an arbitrary custom ODBC
- library. The parameter is the base directory and defaults to
- <filename class="directory">/usr/local</filename>.
- </para>
- <simpara>
- This option implies that you have defined CUSTOM_ODBC_LIBS
- when you run the configure script. You also must have a valid
- odbc.h header somewhere in your include path. If you don't
- have one, create it and include your specific header from
- there. Your header may also require some extra definitions,
- particularly when it is multiplatform. Define them in
- CFLAGS.
- </simpara>
- <simpara>
- For example, you can use Sybase SQL Anywhere on QNX as
- following:
- <literal>
- CFLAGS=-DODBC_QNX LDFLAGS=-lunix CUSTOM_ODBC_LIBS="-ldblib
- -lodbc" ./configure --with-custom-odbc=/usr/lib/sqlany50
- </literal>
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-unified-odbc">
- <term>
- <parameter>--disable-unified-odbc</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Disable unified ODBC support. Only applicable if iODBC, Adabas,
- Solid, Velocis or a custom ODBC interface is enabled.
- </para>
- <para>
- PHP 4: Option not available in PHP 4
- </para>
- <simpara>
- The Unified ODBC module, which is a common interface to all
- the databases with ODBC-based interfaces, such as Solid, IBM
- DB2 and Adabas D. It also works for normal ODBC libraries.
- Has been tested with iODBC, Solid, Adabas D, IBM DB2 and
- Sybase SQL Anywhere. Requires that one (and only one) of these
- extensions or the Velocis extension is enabled, or a custom ODBC
- library specified. This option is only applicable if one of
- the following options is used: <link
- linkend="install.configure.with-iodbc">--with-iodbc</link>,
- <link
- linkend="install.configure.with-solid">--with-solid</link>,
- <link
- linkend="install.configure.with-ibm-db2">--with-ibm-db2</link>,
- <link
- linkend="install.configure.with-adabas">--with-adabas</link>,
- <link
- linkend="install.configure.with-velocis">--with-velocis</link>,
- or <link
- linkend="install.configure.with-custom-odbc">--with-custom-odbc</link>.
- </simpara>
- <simpara>
- See also <link linkend="ini.sect.uodbc">Unified ODBC
- Configuration</link> Directives in the <link
- linkend="configuration.file">configuration
- file</link>.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-unixODBC">
- <term>
- <parameter>--with-unixODBC[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include unixODBC support. DIR is the unixODBC base install
- directory, defaults to /usr/local.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-velocis">
- <term>
- <parameter>--with-velocis[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include Velocis support. DIR is the Velocis base install
- directory, defaults to /usr/local/velocis.
- </para>
- <simpara>
- <ulink url="&url.velocis;">Velocis home page</ulink>
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2 id="install.configure.ecommerce">
- <title>Ecommerce</title>
-
- <variablelist>
- <varlistentry id="install.configure.with-ccvs">
- <term>
- <parameter>--with-ccvs[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Compile CCVS support into PHP 4. Please specify your CCVS base
- install directory as DIR.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-mck">
- <term>
- <parameter>--with-mck[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include Cybercash MCK support. DIR is the cybercash mck
- build directory, which defaults to
- <filename>/usr/src/mck-3.2.0.3-linux</filename>. For help, look
- in <filename>extra/cyberlib</filename>.
- </para>
- <para>
- PHP 4: Option not available; use <link
- linkend="install.configure.with-cybercash">--with-cybercash</link>
- instead.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-cybercash">
- <term>
- <parameter>--with-cybercash[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available; use <link
- linkend="install.configure.with-mck">--with-mck</link>
- instead.
- </para>
- <para>
- PHP 4: Include CyberCash support. DIR is the CyberCash MCK install
- directory.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-pfpro">
- <term>
- <parameter>--with-pfpro[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include Verisign Payflow Pro support
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- </sect2>
-
- <sect2 id="install.configure.graphics">
- <title>Graphics</title>
-
- <variablelist>
- <varlistentry id="install.configure.enable-freetype-4bit-antialias-hack">
- <term>
- <parameter>--enable-freetype-4bit-antialias-hack</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Include support for FreeType2 (experimental).
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-gd">
- <term>
- <parameter>--with-gd[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include GD support (DIR is GD's install dir).
- </para>
- <para>
- PHP 4: Include GD support (DIR is GD's install dir). Set DIR to shared
- to build as a dl, or shared,DIR to build as a dl and still specify DIR.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.without-gd">
- <term>
- <parameter>--without-gd</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Disable GD support.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-imagick">
- <term>
- <parameter>--with-imagick[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Include ImageMagick support. DIR is the install
- directory, and if left out, PHP will try to find it on its
- own. [experimental]
- </para>
- <para>
- PHP 4: Option not available in PHP 4
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-jpeg-dir">
- <term>
- <parameter>--with-jpeg-dir[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: jpeg dir for pdflib 2.0
- </para>
- <para>
- PHP 4: jpeg dir for pdflib 3.x
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-png-dir">
- <term>
- <parameter>--with-png-dir[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: png dir for pdflib 3.x
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-t1lib">
- <term>
- <parameter>--enable-t1lib</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Enable t1lib support.
- </para>
- <para>
- PHP 4: Option not available; use <link
- linkend="install.configure.with-t1lib">--with-t1lib</link>
- instead.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-t1lib">
- <term>
- <parameter>--with-t1lib[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available; use <link
- linkend="install.configure.enable-t1lib">--enable-t1lib</link>
- instead.
- </para>
- <para>
- PHP 4: Include T1lib support.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-tiff-dir">
- <term>
- <parameter>--with-tiff-dir[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: tiff dir for pdflib 2.0
- </para>
- <para>
- PHP 4: tiff dir for pdflib 3.x
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-ttf">
- <term>
- <parameter>--with-ttf[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Include FreeType support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.with-xpm-dir">
- <term>
- <parameter>--with-xpm-dir[=DIR]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: xpm dir for gd-1.8+
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2 id="install.configure.misc">
- <title>Miscellaneous</title>
-
- <para>
- These are being classified over time, where appropriate.
- </para>
-
- <variablelist>
- <varlistentry id="install.configure.disable-bcmath">
- <term>
- <parameter>--disable-bcmath</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Compile without BC arbitrary precision math
- functions. These functions allow you to operate with numbers
- outside of the ranges allowed by regular integers and floats;
- see <link linkend="ref.bc">BCMath Arbitrary Precision
- Mathematics Functions</link> for more information.
- </para>
- <para>
- PHP 4: Option not available; bcmath is not compiled in by
- default. Use <link
- linkend="install.configure.enable-bcmath">--enable-bcmath</link>
- to compile it in.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-display-source">
- <term>
- <parameter>--disable-display-source</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Compile without displaying source support
- </para>
- <para>
- PHP 4: Option not available in PHP 4
- </para>
- </listitem>
- </varlistentry>
-
+ <varlistentry id="install.configure.disable-display-source">
+ <term>
+ <parameter>--disable-display-source</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Compile without displaying source support
+ </para>
+ <para>
+ PHP 4: Option not available in PHP 4
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="install.configure.disable-libtool-lock">
- <term>
- <parameter>--disable-libtool-lock</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: avoid locking (might break parallel builds)
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-pear">
- <term>
- <parameter>--disable-pear</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Do not install PEAR
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-pic">
- <term>
- <parameter>--disable-pic</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Disable PIC for shared objects
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-posix">
- <term>
- <parameter>--disable-posix</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3; use <link
- linkend="install.configure.without-posix">--without-posix</link>
- instead.
- </para>
- <para>
- PHP 4: Disable POSIX-like functions
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-rpath">
- <term>
- <parameter>--disable-rpath</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Disable passing additional runtime library search paths
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.disable-session">
- <term>
- <parameter>--disable-session</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Disable session support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-bcmath">
- <term>
- <parameter>--enable-bcmath</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3; bcmath is compiled in
- by default. Use <link
- linkend="install.configure.disable-bcmath">--disable-bcmath</link>
- to disable it.
- </para>
- <para>
- PHP 4: Compile with bc style precision math functions. Read
- README-BCMATH for instructions on how to get this module
- installed. These functions allow you to operate with numbers
- outside of the ranges allowed by regular integers and floats;
- see <link linkend="ref.bc">BCMath Arbitrary Precision
- Mathematics Functions</link> for more information.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-c9x-inline">
- <term>
- <parameter>--enable-c9x-inline</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable C9x-inline semantics
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-calendar">
- <term>
- <parameter>--enable-calendar</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable support for calendar conversion
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-debug">
- <term>
- <parameter>--enable-debug</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Compile with debugging symbols.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-debugger">
- <term>
- <parameter>--enable-debugger</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Compile with remote debugging functions
- </para>
- <para>
- PHP 4: Option not available in PHP 4
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-discard-path">
- <term>
- <parameter>--enable-discard-path</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: 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="install.configure.enable-dmalloc">
- <term>
- <parameter>--enable-dmalloc</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enable dmalloc
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-exif">
- <term>
- <parameter>--enable-exif</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable exif support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-experimental-zts">
- <term>
- <parameter>--enable-experimental-zts</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: This will most likely break your build
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-fast-install">
- <term>
- <parameter>--enable-fast-install[=PKGS]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: optimize for fast installation [default=yes]
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-force-cgi-redirect">
- <term>
- <parameter>--enable-force-cgi-redirect</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enable the security check for internal server redirects.
- You should use this if you are running the CGI version with Apache.
- </para>
- </listitem>
- </varlistentry>
-
+ <term>
+ <parameter>--disable-libtool-lock</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: avoid locking (might break parallel builds)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-pear">
+ <term>
+ <parameter>--disable-pear</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Do not install PEAR
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-pic">
+ <term>
+ <parameter>--disable-pic</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Disable PIC for shared objects
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-posix">
+ <term>
+ <parameter>--disable-posix</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3; use <link
+ linkend="install.configure.without-posix">--without-posix</link>
+ instead.
+ </para>
+ <para>
+ PHP 4: Disable POSIX-like functions
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-rpath">
+ <term>
+ <parameter>--disable-rpath</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Disable passing additional runtime library search paths
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.disable-session">
+ <term>
+ <parameter>--disable-session</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Disable session support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-bcmath">
+ <term>
+ <parameter>--enable-bcmath</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3; bcmath is compiled in
+ by default. Use <link
+ linkend="install.configure.disable-bcmath">--disable-bcmath</link>
+ to disable it.
+ </para>
+ <para>
+ PHP 4: Compile with bc style precision math functions. Read
+ README-BCMATH for instructions on how to get this module
+ installed. These functions allow you to operate with numbers
+ outside of the ranges allowed by regular integers and floats;
+ see <link linkend="ref.bc">BCMath Arbitrary Precision
+ Mathematics Functions</link> for more information.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-c9x-inline">
+ <term>
+ <parameter>--enable-c9x-inline</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable C9x-inline semantics
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-calendar">
+ <term>
+ <parameter>--enable-calendar</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable support for calendar conversion
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-debug">
+ <term>
+ <parameter>--enable-debug</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Compile with debugging symbols.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-debugger">
+ <term>
+ <parameter>--enable-debugger</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Compile with remote debugging functions
+ </para>
+ <para>
+ PHP 4: Option not available in PHP 4
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-discard-path">
+ <term>
+ <parameter>--enable-discard-path</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: 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="install.configure.enable-dmalloc">
+ <term>
+ <parameter>--enable-dmalloc</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Enable dmalloc
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-exif">
+ <term>
+ <parameter>--enable-exif</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable exif support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-experimental-zts">
+ <term>
+ <parameter>--enable-experimental-zts</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: This will most likely break your build
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-fast-install">
+ <term>
+ <parameter>--enable-fast-install[=PKGS]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: optimize for fast installation [default=yes]
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-force-cgi-redirect">
+ <term>
+ <parameter>--enable-force-cgi-redirect</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: 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="install.configure.enable-inline-optimization">
- <term>
- <parameter>--enable-inline-optimization</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: If you have much memory and are using gcc, you might try this.
- </para>
- </listitem>
- </varlistentry>
-
+ <term>
+ <parameter>--enable-inline-optimization</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: If you have much memory and are using gcc, you might try this.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="install.configure.enable-libgcc">
- <term>
- <parameter>--enable-libgcc</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable explicitly linking against libgcc
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-maintainer-mode">
- <term>
- <parameter>--enable-maintainer-mode</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: enable make rules and dependencies not useful (and
- sometimes confusing) to the casual installer
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-memory-limit">
- <term>
- <parameter>--enable-memory-limit</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Compile with memory limit support. [default=no]
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-safe-mode">
- <term>
- <parameter>--enable-safe-mode</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enable safe mode by default.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-satellite">
- <term>
- <parameter>--enable-satellite</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable CORBA support via Satellite (Requires ORBit)
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-shared">
- <term>
- <parameter>--enable-shared[=PKGS]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: build shared libraries [default=yes]
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-sigchild">
- <term>
- <parameter>--enable-sigchild</parameter>
- </term>
- <listitem>
- <para>
+ <term>
+ <parameter>--enable-libgcc</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable explicitly linking against libgcc
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-maintainer-mode">
+ <term>
+ <parameter>--enable-maintainer-mode</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: enable make rules and dependencies not useful (and
+ sometimes confusing) to the casual installer
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-memory-limit">
+ <term>
+ <parameter>--enable-memory-limit</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Compile with memory limit support. [default=no]
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-safe-mode">
+ <term>
+ <parameter>--enable-safe-mode</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Enable safe mode by default.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-satellite">
+ <term>
+ <parameter>--enable-satellite</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable CORBA support via Satellite (Requires ORBit)
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-shared">
+ <term>
+ <parameter>--enable-shared[=PKGS]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: build shared libraries [default=yes]
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-sigchild">
+ <term>
+ <parameter>--enable-sigchild</parameter>
+ </term>
+ <listitem>
+ <para>
PHP 3, PHP 4: Enable PHP's own SIGCHLD handler.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-static">
- <term>
- <parameter>--enable-static[=PKGS]</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: build static libraries [default=yes]
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-sysvsem">
- <term>
- <parameter>--enable-sysvsem</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enable System V semaphore support.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-sysvshm">
- <term>
- <parameter>--enable-sysvshm</parameter>
- </term>
- <listitem>
- <para>
- PHP 3, PHP 4: Enable the System V shared memory support
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="install.configure.enable-trans-sid">
- <term>
- <parameter>--enable-trans-sid</parameter>
- </term>
- <listitem>
- <para>
- PHP 3: Option not available in PHP 3
- </para>
- <para>
- PHP 4: Enable transparent session id propagation
- </para>
- </listitem>
- </varlistentry>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-static">
+ <term>
+ <parameter>--enable-static[=PKGS]</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: build static libraries [default=yes]
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-sysvsem">
+ <term>
+ <parameter>--enable-sysvsem</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Enable System V semaphore support.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-sysvshm">
+ <term>
+ <parameter>--enable-sysvshm</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3, PHP 4: Enable the System V shared memory support
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry id="install.configure.enable-trans-sid">
+ <term>
+ <parameter>--enable-trans-sid</parameter>
+ </term>
+ <listitem>
+ <para>
+ PHP 3: Option not available in PHP 3
+ </para>
+ <para>
+ PHP 4: Enable transparent session id propagation
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="install.configure.with-cdb">
<term>
@@ -2253,14 +2171,14 @@
PHP 3, PHP 4: Disable the URL-aware fopen wrapper that allows accessing
files via http or ftp.
</para>
- <warning>
- <para>
- This switch is only available for PHP versions up to 4.0.3, newer
- versions provide an INI parameter called
+ <warning>
+ <para>
+ This switch is only available for PHP versions up to 4.0.3, newer
+ versions provide an INI parameter called
<parameter>allow_url_fopen</parameter> instead of forcing you to
decide upon this feature at compile time.
- </para>
- </warning>
+ </para>
+ </warning>
</listitem>
</varlistentry>
@@ -2501,10 +2419,10 @@
</para>
<para>
PHP 4: Build PHP as a Pike module for use with the Caudium
- webserver. DIR is the Caudium base directory. If no directory
- is specified $prefix/caudium/server is used. The prefix is
- controlled by the --prefix option and is /usr/local per
- default.
+ webserver. DIR is the Caudium base directory. If no directory
+ is specified $prefix/caudium/server is used. The prefix is
+ controlled by the --prefix option and is /usr/local per
+ default.
</para>
</listitem>
</varlistentry>
@@ -2785,7 +2703,7 @@
<para>
There are two main ways to install PHP for Windows: either
<link linkend="install.windows.manual">manually</link>
- or by using an <link linkend="install.windows.installer">InstallShield</link>
+ or by using the <link linkend="install.windows.installer">InstallShield</link>
installer.
</para>
<para>
@@ -2804,7 +2722,7 @@
<para>
The Windows PHP installer available from the downloads page at
- <ulink url="&url.php;">&url.php;</ulink> installs the CGI version
+ <ulink url="&url.php;">&url.php;</ulink>, this installs the CGI version
of PHP and, for IIS, PWS, and Xitami, configures the web server as
well.
</para>
@@ -2840,62 +2758,62 @@
<sect2 id="install.windows.manual">
<title>General Installation Steps</title>
- <simpara>
- This install guide will help you manually install and configure
- PHP on your Windows 9x/Me/NT/2000 webservers. This guide was compiled by
- &link.bob;. The original version can be found at <ulink
- url="&url.win32install;">&url.win32install;</ulink>.
- </simpara>
- <para>
- This guide provides manual installation support for:
- <itemizedlist>
- <listitem>
- <para>
- Personal Web Server 3 and 4 or newer
- </para>
- </listitem>
- <listitem>
- <para>
- Internet Information Server 3 and 4 or newer
- </para>
- </listitem>
- <listitem>
- <para>
- Apache 1.3.x
- </para>
- </listitem>
- <listitem>
- <para>
- OmniHTTPd 2.0b1 and up
- </para>
- </listitem>
- <listitem>
- <para>
- Oreilly Website Pro
- </para>
- </listitem>
- <listitem>
- <para>
- Xitami
- </para>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- PHP 4 for Windows comes in two flavours - a CGI executable (php.exe),
- and several SAPI modules (for exapmle php4isapi.dll). The latter form
- is new to PHP 4, and provides significantly improved performance and
- some new functionality. However, please note that the SAPI modules
- are <emphasis>NOT</emphasis> yet considered to be production quality.
- The reason for this is that the PHP SAPI modules are using the
- thread-safe version of the PHP code, which is new to PHP 4, and has
- not yet been tested and pounded enough to be considered completely
- stable, and there are actually a few known bugs. On the other hand,
- some people have reported very good results with the SAPI modules,
- even though we're not aware of anyone actually running it on a
- production site. In short - your mileage may vary; If you need
- absolute stability, trade the performance of the SAPI modules
- with the stability of the CGI executable.
+ <simpara>
+ This install guide will help you manually install and configure
+ PHP on your Windows 9x/Me/NT/2000 webservers. This guide was compiled by
+ &link.bob;. The original version can be found at <ulink
+ url="&url.win32install;">&url.win32install;</ulink>.
+ </simpara>
+ <para>
+ This guide provides manual installation support for:
+ <itemizedlist>
+ <listitem>
+ <para>
+ Personal Web Server 3 and 4 or newer
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Internet Information Server 3 and 4 or newer
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Apache 1.3.x
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ OmniHTTPd 2.0b1 and up
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Oreilly Website Pro
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Xitami
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ PHP 4 for Windows comes in two flavours - a CGI executable (php.exe),
+ and several SAPI modules (for exapmle php4isapi.dll). The latter form
+ is new to PHP 4, and provides significantly improved performance and
+ some new functionality. However, please note that the SAPI modules
+ are <emphasis>NOT</emphasis> yet considered to be production quality.
+ The reason for this is that the PHP SAPI modules are using the
+ thread-safe version of the PHP code, which is new to PHP 4, and has
+ not yet been tested and pounded enough to be considered completely
+ stable, and there are actually a few known bugs. On the other hand,
+ some people have reported very good results with the SAPI modules,
+ even though we're not aware of anyone actually running it on a
+ production site. In short - your mileage may vary; If you need
+ absolute stability, trade the performance of the SAPI modules
+ with the stability of the CGI executable.
</para>
<para>
If you choose one of the SAPI modules and use Windows 95, be sure
@@ -2910,7 +2828,6 @@
<para>
The following steps should be performed on all installations
before the server specific instructions.
-
<itemizedlist>
<listitem>
<para>
@@ -3507,7 +3424,7 @@
<para>
If you would like to use PHP as a module in Apache,
you should move <filename>php4ts.dll</filename> to
- the windows/system (for Windows 9x/Me) or windows/system32
+ the windows/system (for Windows 9x/Me) or winnt/system32
(for Windows NT/2000) directory, overwriting any older file.
Then you should add the following two lines to you Apache
conf file:
@@ -3534,8 +3451,8 @@
script file and stick this code in: <literal><?php show_source
("original_php_script.php"); ?></literal>. Substitute
<literal>original_php_script.php</literal> with the name of the
- file you wish to show the source of. (This is only one way of
- doing it).
+ file you wish to show the source of. (This is the only way of
+ doing so).
</simpara>
<note>
<simpara>
@@ -3629,11 +3546,12 @@
6. Restart Caudium if it's currently running.
7. Log into the graphical configuration interface and go to the
virtual server where you want to add PHP 4 support.
-8. Click Add Module and locate and add the PHP 4 Script Support module.
+8. Click Add Module and locate and then add the PHP 4 Script Support module.
9. If the documentation says that the 'PHP 4 interpreter isn't
available', make sure that you restarted the server. If you did
check /opt/caudium/logs/debug/default.1 for any errors related to
- PHP 4.so. Also make sure that caudium/server/lib/[pike-version]/PHP4.so
+ <filename>PHP4.so</filenane>. Also make sure that
+ caudium/server/lib/[pike-version]/PHP4.so
is present.
10. Configure the PHP Script Support module if needed.
</programlisting>
@@ -3660,7 +3578,7 @@
<title>IIS/PWS Server installs</title>
<para>
This section contains notes and hints specific to IIS (Microsoft
- Internet Information Server) installs of PHP for
+ Internet Information Server) installing PHP for
<link linkend="install.iis.iis3">PWS/IIS 3</link>,
<link linkend="install.iis.pws4">PWS 4 or newer</link> and
<link linkend="install.iis.iis4">IIS 4 or newer</link> versions.
@@ -3820,7 +3738,7 @@
<simpara>
When installing PHP on Windows with PWS 4 or newer version,
- you have to options. One to set up the PHP CGI binary,
+ you have two options. One to set up the PHP CGI binary,
the other is to use the ISAPI module dll.
</simpara>
@@ -3881,13 +3799,13 @@
In either case, you need to start the Microsoft Management
Console (may appear as 'Internet Services Manager', either
in your Windows NT 4.0 Option Pack branch or the Control
- Panel->Administrative Tools under Windows 2000). Then
- right click on your Web server node (will most probably
+ Panel=>Administrative Tools under Windows 2000). Then
+ right click on your Web server node (this will most probably
appear as 'Default Web Server'), and select 'Properties'.
</simpara>
<para>
- Now if you want to use the CGI binary, do the following:
+ If you want to use the CGI binary, do the following:
<itemizedlist>
<listitem>
<simpara>
@@ -3911,7 +3829,7 @@
associated with PHP scripts. Leave 'Method exclusions'
blank, and check the Script engine checkbox.
You must repeat step 3 and 4 for each extension you
- want accociated with PHP scripts.
+ want associated with PHP scripts.
(<literal>.php</literal> and <literal>.phtml</literal>
are common.)
</simpara>
@@ -4150,10 +4068,10 @@
You can choose at setup time to do a custom setup, and
uncheck the PHP component. We recommend you to use the latest
PHP binaries. Some OmniHTTPd servers come with PHP 4 beta
- distributions, so you should rather choose not to set up
+ distributions, so you should choose not to set up
the built in support, but install your own. If the server
is already on your machine, use the Replace button in Step
- 4 and 5 to set the new information.
+ 4 and 5 to set the new, correct information.
</para>
</note>
</sect2>
@@ -4191,7 +4109,7 @@
</listitem>
<listitem>
<para>
- Now select "Content Types" add the same extension ".php"
+ Select "Content Types" add the same extension ".php"
and enter the content type. If you choose the CGI exe
file, enter 'wwwserver/shellcgi', if you chosse the
ISAPI module, enter 'wwwserver/isapi' (both without
@@ -4228,7 +4146,7 @@
</listitem>
<listitem>
<para>
- Now navigate to the Filters, and put the
+ Navigate to the Filters, and put the
extension which php should parse (i.e. .php)
into the field File extensions (.xxx).
</para>
