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

From: Date: Mon, 05 Oct 2009 13:00:29 +0000
Subject: svn: /phpdoc/en/trunk/install/unix/ apache2.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-5068@lists.php.net to get a copy of this message
rbowen Mon, 05 Oct 2009 13:00:29 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=289213 Log: Converting (most of) the language to the third-person perspective suggested by the style guide. 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-05 10:10:20 UTC (rev 289212) +++ phpdoc/en/trunk/install/unix/apache2.xml 2009-10-05 13:00:29 UTC (rev 289213) @@ -10,22 +10,24 @@ &warn.apache2.compat; <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.x Server. + The <link xlink:href="&url.apache2.docs;">Apache Documentation</link> + is the most authoritative source of information on the Apache 2.x server. + More information about installation options for Apache may be found + there. </para> &install.snippet.apache2.compat; <para> - Download the most recent version of <link xlink:href="&url.apache;"> - Apache 2.x</link> and a fitting PHP version from the above mentioned places. + The most receive version of Apache HTTP Server may be obtained from + <link xlink:href="&url.apache;">Apache download site</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. + instructions are not incorrect. In the examples below, 'NN' should be + replaced with the specific version of Apache being used. </para> <para> There are currently two versions of Apache 2.x - there's 2.0 and 2.2. @@ -95,12 +97,6 @@ module on your system. The make install from above may have already added this for you, but be sure to check. - For PHP 4: - - LoadModule php4_module modules/libphp4.so - - For PHP 5: - LoadModule php5_module modules/libphp5.so 15. Tell Apache to parse certain extensions as PHP. For example, let's have @@ -128,12 +124,17 @@ SetHandler application/x-httpd-php-source </FilesMatch> - To allow any arbitrary .php file to be displayed as syntax-highlighted - source code, without having to rename or copy it to a .phps file, do this: + mod_rewrite may be used To allow any arbitrary .php file to be displayed + as syntax-highlighted source code, without having to rename or copy it + to a .phps file: RewriteEngine On RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source] + The php source filter should not be enabled on production systems, where + it may expose confidential or otherwise sensitive information embedded in + source code. + 16. Use your normal procedure for starting the Apache server, e.g.: /usr/local/apache2/bin/apachectl start @@ -151,36 +152,39 @@ support for PHP as a <literal>SAPI</literal> module. Of course there are 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 - 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: + source tree. </para> + <para> + Apache may be built multithreaded by selecting the + <filename>worker</filename> MPM, rather than the standard + <filename>prefork</filename> MPM, when Apache is built. This is done by + adding the following option to the argument passed to ./configure, 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>. + This should not be undertaken without being aware of the consequences of + this decision, and having at least a fair understanding of + the implications. The Apache documentation + regarding <link xlink:href="&url.apache2.mpm;">MPM-Modules</link> + discusses MPMs in a great deal more detail. </para> <note> <para> - If you want to use content negotiation, read the - <link linkend="faq.installation.apache.multiviews">Apache MultiViews - FAQ</link>. + The <link linkend="faq.installation.apache.multiviews">Apache MultiViews + FAQ</link> discusses using multiviews with PHP. </para> </note> <note> <para> - To build a multithreaded version of Apache your system must support threads. - You should also build PHP with experimental + To build a multithreaded version of Apache, the target system must support threads. + In this case, PHP should also be built 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 + The recommended setup is to build Apache with the default <filename>prefork</filename> MPM-Module. </para> </note>

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