svn: /phpdoc/en/trunk/install/unix/ apache2.xml

From: 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>

« previous php.doc.cvs (#5035) next »