svn: /phpdoc/en/trunk/install/unix/ apache2.xml
| From: | Rich Bowen | 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>