some rewording

less confusing version numbers; thanks to Goba


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@103611 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Friedhelm Betz 2002-11-13 00:35:20 +00:00
parent 342ff85558
commit 120af91555

View file

@ -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">
<![CDATA[
ScriptAlias /php/ "c:/php/"
@ -181,7 +204,7 @@ Action application/x-httpd-php "/php/php.exe"
</note>
<para>
<example>
<title>PHP 4.3.0 and Apache 2.0</title>
<title>PHP 4.3.0 prerelease and Apache 2.0</title>
<programlisting role="apache">
<![CDATA[
ScriptAlias /php/ "c:/php/"
@ -212,7 +235,7 @@ AddType application/x-httpd-php .php
<para>
Remember to substitute the <filename>c:/php/</filename> for your actual
path to <literal>PHP</literal> in the above examples. Don't mix up your
installation with dll files from <emphasis>different PHP Versions
installation with dll files from <emphasis>different PHP versions
</emphasis>. You have the only choice to use the dll's and extensions
that ship with your downloaded PHP version.
</para>