betz Tue Nov 12 19:35:21 2002 EDT
Modified files:
/phpdoc/en/chapters install.apache2.xml
Log:
some rewording
less confusing version numbers; thanks to Goba
Index: phpdoc/en/chapters/install.apache2.xml
diff -u phpdoc/en/chapters/install.apache2.xml:1.1
phpdoc/en/chapters/install.apache2.xml:1.2
--- phpdoc/en/chapters/install.apache2.xml:1.1 Mon Nov 11 08:20:48 2002
+++ phpdoc/en/chapters/install.apache2.xml Tue Nov 12 19:35:20 2002
@@ -1,50 +1,71 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<sect1 id="install.apache2">
<title>Servers-Apache 2.0</title>
<para>
This section contains notes and hints specific to Apache 2.0 installs
- of <literal>PHP</literal>, both for <link
linkend="install.apache2.unix">Unix</link>
+ of <literal>PHP</literal>, both for
+ <link linkend="install.apache2.unix">Unix</link>
and <link linkend="install.apache2.windows">Windows</link> versions.
</para>
- <warning>
- <para>
- Do not use Apache 2.0 and <literal>PHP</literal> in a production
- environment neither on Unix nor on Windows.
- </para>
- </warning>
- <para>
- You are highly encouraged to take a look at the
- <ulink url="&url.apache2.docs;">Apache Documentation</ulink> to get
- a basic understanding of the Apache 2.0 Server.
- </para>
+ <warning>
+ <para>
+ Do not use Apache 2.0 and <literal>PHP</literal> in a production
+ environment neither on Unix nor on Windows.
+ </para>
+ </warning>
+ <para>
+ You are highly encouraged to take a look at the
+ <ulink url="&url.apache2.docs;">Apache Documentation</ulink> to get
+ a basic understanding of the Apache 2.0 Server.
+ </para>
<sect2 id="compat.apache2">
<title>PHP and Apache 2.0 compatibility notes</title>
<para>
- Apache 2.0 support started with PHP 4.2.0. If you want to use Apache 2.0 its
- recommended to use PHP 4.3.0-dev with the most recent version of Apache 2.0.
- PHP 4.2.4 and PHP 4.3.0-dev are compatible to Apache 2.0.40 and later.
+ As long as PHP 4.3.0 is not released, we recommend to use one of the
+ following versions with the most recent version of Apache 2.0:
+ <itemizedlist spacing="compact">
+ <listitem>
+ <simpara>
+ the latest stable development versions downloadable from
+ <ulink url="&url.php.snapshots;">&url.php.snapshots;</ulink>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ a prerelease version of PHP 4.3.0 downloadable from
+ <ulink url="&url.php.prerelease;">&url.php.prerelease;</ulink>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ you have always the option to obtain <literal>PHP</literal> through
+ <ulink url="&url.php.anoncvs;">anonymous CVS</ulink>.
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ These versions of <literal>PHP</literal> are compatible to Apache 2.0.40 and
+later.
</para>
<note>
<simpara>
+ Apache 2.0 <literal>SAPI</literal>-support started with PHP 4.2.0.
PHP 4.2.3 its known to work in conjunction with Apache 2.0.39. Don't try to use
this version of <literal>PHP</literal> with any other version of Apache.
+ We do not recommend to use PHP 4.2.3 along with Apache 2.0.39.
+ </simpara>
+ <simpara>
+ All mentioned versions of <literal>PHP</literal> will work still with
+ Apache 1.3.x.
</simpara>
</note>
- <para>
- You have several choices to get a version of <literal>PHP</literal>
- which works together with Apache 2.0. Download the
- <ulink url="&url.php.snapshots;">latest stable snapshot</ulink>
- (PHP 4.2.4) or the <ulink url="&url.php.prerelease;">pre-release</ulink>
- (PHP 4.3.0-devel). Of course, you have always the option to obtain
- <literal>PHP</literal> through <ulink url="&url.php.anoncvs;">anonymous
CVS</ulink>.
- </para>
</sect2>
<sect2 id="install.apache2.unix">
<title>PHP and Apache 2 on Linux</title>
<para>
+ Download the most recent version of <ulink url= "&url.apache;">
+ Apache 2.0</ulink> and a fitting PHP version from the above mentioned places.
This quick guide covers only the basics to get started with Apache 2.0
and <literal>PHP</literal>. For more information read the
<ulink url="&url.apache2.docs;">Apache Documentation</ulink>.
@@ -66,10 +87,11 @@
6. ./configure --enable-so
7. make
8. make install
+
Now you have Apache 2.0.NN available under /usr/local/apache2,
- configured with the standard MPM prefork.
+ configured with loadable module support and the standard MPM prefork.
To test the installation use your normal procedure for starting
- the Apache server, e.g:
+ the Apache server, e.g.:
/usr/local/apache2/bin/apachectl start
and stop the server to go on with the configuration for PHP:
/usr/local/apache2/bin/apachectl stop.
@@ -97,7 +119,7 @@
to the path of the PHP module on your system. The above statement is
correct for the steps shown above.
-15. Use your normal procedure for starting the Apache server, e.g:
+15. Use your normal procedure for starting the Apache server, e.g.:
/usr/local/apache2/bin/apachectl start
]]>
@@ -106,14 +128,14 @@
</example>
<para>
Following the steps above you will have a running Apache 2.0 with
- support for <literal>PHP</literal>. Of course there are many more
- configuration options available for both, Apache and
- <literal>PHP</literal>. For more information use
+ support for <literal>PHP</literal> as <literal>SAPI</literal> module.
+ Of course there are many more configuration options available for both,
+ Apache and <literal>PHP</literal>. For more information use
<command>./configure --help</command> in the corresponding source
tree. In case you wish to build a multithreaded version of Apache 2.0
you must overwrite the standard MPM-Module <filename>prefork</filename>
either with <filename>worker</filename> or <filename>perchild</filename>.
- Append to your configure line in step 6 above either the option
+ To do so append to your configure line in step 6 above either the option
<option role="configure">--with-mpm=worker</option> or
<option role="configure">--with-mpm=perchild</option>. Take care about
the consequences and understand what you are doing. For more information
@@ -125,7 +147,8 @@
To build a multithreaded version of Apache your system must support threads.
This also implies to build <literal>PHP</literal> with experimental
Zend Thread Safety (ZTS). Therefore not all extensions might be available.
- The recommended setup is to build Apache with the standard prefork MPM-Module.
+ The recommended setup is to build Apache with the standard
+ <filename>prefork</filename> MPM-Module.
</para>
</note>
</sect2>
@@ -134,7 +157,7 @@
<title>PHP and Apache 2.0 on Windows</title>
<para>
Consider to read the <ulink url="&url.apache2.windows;">
- Windows specific Notes</ulink> for Apache 2.0.
+ Windows specific notes</ulink> for Apache 2.0.
</para>
<warning>
<para>
@@ -152,7 +175,7 @@
</para>
<para>
There are two ways to set up <literal>PHP</literal> to work with
- Apache 2.0.4x on Windows. One is to use the CGI binary the other is to
+ Apache 2.0 on Windows. One is to use the CGI binary the other is to
use the Apache module DLL. In either case you need to stop the Apache
server, and edit your <filename>httpd.conf</filename> to configure Apache
to work with <literal>PHP</literal>.
@@ -162,7 +185,7 @@
</filename> configuration file to set up the
<emphasis>CGI binary</emphasis>:
<example>
- <title>PHP 4.2.4 and Apache 2.0</title>
+ <title>PHP development version and Apache 2.0</title>
<programlisting role="apache">
<