svn: /phpdoc/en/trunk/install/unix/ apache2.xml
| From: | Rich Bowen | Date: | Fri, 02 Oct 2009 20:49:17 +0000 |
| Subject: | svn: /phpdoc/en/trunk/install/unix/ apache2.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-5035@lists.php.net to get a copy of this message | ||
rbowen Fri, 02 Oct 2009 20:49:17 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=289100
Log:
Gramatical improvements, and change references to 2.0 to refer instead
to 2.x, with a brief remark about 2.0 vs 2.2. Will revisit for
third-person style.
Changed paths:
U phpdoc/en/trunk/install/unix/apache2.xml
Modified: phpdoc/en/trunk/install/unix/apache2.xml
===================================================================
--- phpdoc/en/trunk/install/unix/apache2.xml 2009-10-02 20:47:52 UTC (rev 289099)
+++ phpdoc/en/trunk/install/unix/apache2.xml 2009-10-02 20:49:17 UTC (rev 289100)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Apache 2.0 on Unix systems</title>
+ <title>Apache 2.x on Unix systems</title>
<para>
- This section contains notes and hints specific to Apache 2.0 installs
+ This section contains notes and hints specific to Apache 2.x installs
of PHP on Unix systems.
</para>
@@ -12,37 +12,44 @@
<para>
You are highly encouraged to take a look at the
<link xlink:href="&url.apache2.docs;">Apache Documentation</link> to
get
- a basic understanding of the Apache 2.0 Server.
+ a basic understanding of the Apache 2.x Server.
</para>
&install.snippet.apache2.compat;
<para>
Download the most recent version of <link xlink:href="&url.apache;">
- Apache 2.0</link> and a fitting PHP version from the above mentioned places.
- This quick guide covers only the basics to get started with Apache 2.0
+ Apache 2.x</link> and a fitting PHP version from the above mentioned places.
+ This quick guide covers only the basics to get started with Apache 2.x
and PHP. For more information read the
<link xlink:href="&url.apache2.docs;">Apache Documentation</link>.
The version numbers have been omitted here, to ensure the
instructions are not incorrect. You will need to replace the
'NN' here with the correct values from your files.
</para>
+ <para>
+ There are currently two versions of Apache 2.x - there's 2.0 and 2.2.
+ While there are various reasons for choosing each, 2.2 is the current
+ latest version, and the one that is recommended, if that option is
+ available to you. However, the instructions here will work for either
+ 2.0 or 2.2.
+ </para>
<example>
<title>
Installation Instructions (Apache 2 Shared Module Version)
</title>
<screen>
<![CDATA[
-1. gzip -d httpd-2_0_NN.tar.gz
-2. tar xvf httpd-2_0_NN.tar
+1. gzip -d httpd-2_x_NN.tar.gz
+2. tar xvf httpd-2_x_NN.tar
3. gunzip php-NN.tar.gz
4. tar -xvf php-NN.tar
-5. cd httpd-2_0_NN
+5. cd httpd-2_x_NN
6. ./configure --enable-so
7. make
8. make install
- Now you have Apache 2.0.NN available under /usr/local/apache2,
+ Now you have Apache 2.x.NN available under /usr/local/apache2,
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.:
@@ -138,12 +145,19 @@
many more configuration options available Apache and PHP. For more
information type <command>./configure --help</command> in the corresponding
source tree. If you wish to build a multithreaded version of Apache2, you
- must overwrite the standard MPM-Module <filename>prefork</filename> either
- with <filename>worker</filename> or <filename>perchild</filename>. 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>. Before doing so,
- please beware the consequences and have at least a fair understand of what
+ should select the <filename>worker</filename> MPM, rather than the
+ standard <filename>prefork</filename> MPM when you build Apache.
+ To do this, add the following option to your configure line in step 6
+ above:
+ </para>
+ <example>
+ <screen>
+ --with-mpm=worker
+ </screen>
+ </example>
+ <para>
+ Before doing so,
+ please be aware of the consequences and have at least a fair understand of
the implications. For more information, read the Apache documentation
regarding <link xlink:href="&url.apache2.mpm;">MPM-Modules</link>.
</para>
@@ -157,8 +171,8 @@
<note>
<para>
To build a multithreaded version of Apache your system must support threads.
- This also implies to build PHP with experimental
- Zend Thread Safety (ZTS). Therefore not all extensions might be available.
+ You should also build PHP with experimental
+ Zend Thread Safety (ZTS). Under this configuration, not all extensions will be available.
The recommended setup is to build Apache with the standard
<filename>prefork</filename> MPM-Module.
</para>