Source of: /manual/en/install.unix.apache2.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/install.unix.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'en',
),
'this' =>
array (
0 => 'install.unix.apache2.php',
1 => 'Apache 2.x on Unix systems',
),
'up' =>
array (
0 => 'install.unix.php',
1 => 'Installation on Unix systems',
),
'prev' =>
array (
0 => 'install.unix.apache.php',
1 => 'Apache 1.3.x on Unix systems',
),
'next' =>
array (
0 => 'install.unix.lighttpd-14.php',
1 => 'Lighttpd 1.4 on Unix systems',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<div id="install.unix.apache2" class="sect1">
<h2 class="title">Apache 2.x on Unix systems</h2>
<p class="para">
This section contains notes and hints specific to Apache 2.x installs
of PHP on Unix systems.
</p>
<div class="warning"><b class="warning">Warning</b><p class="para">We do not recommend using a
threaded MPM in production with Apache 2. Use the prefork MPM instead, or use
Apache 1. For information on why, read the related FAQ entry on using
<a href="faq.installation.php#faq.installation.apache2" class="link">Apache2 with a threaded MPM</a></p></div>
<p class="para">
The <a href="http://httpd.apache.org/docs/2.2/" class="link external">» Apache Documentation</a>
is the most authoritative source of information on the Apache 2.x server.
More information about installation options for Apache may be found
there.
</p>
<blockquote><p><b class="note">Note</b>:
<b>PHP and Apache 2.0.x compatibility notes</b><br />
The following versions of PHP are known to work with the most recent
version of Apache 2.0.x:
</p><ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
PHP 4.3.0 or later available at
<a href="http://www.php.net/downloads.php" class="link external">» http://www.php.net/downloads.php</a>.
</span>
</li>
<li class="listitem">
<span class="simpara">
the latest stable development version.
Get the source code <a href="http://snaps.php.net/php5-latest.tar.gz" class="link external">»
http://snaps.php.net/php5-latest.tar.gz</a> or download binaries
for Windows <a href="http://snaps.php.net/win32/php5-win32-latest.zip" class="link external">»
http://snaps.php.net/win32/php5-win32-latest.zip</a>.
</span>
</li>
<li class="listitem">
<span class="simpara">
a prerelease version downloadable from
<a href="http://qa.php.net/" class="link external">» http://qa.php.net/</a>.
</span>
</li>
<li class="listitem">
<span class="simpara">
you have always the option to obtain PHP through
<a href="http://php.net/svn.php" class="link external">» anonymous SVN</a>.
</span>
</li>
</ul><p>
These versions of PHP are compatible to Apache 2.0.40 and later.
<br />
Apache 2.0 <i>SAPI</i>-support started with PHP 4.2.0.
PHP 4.2.3 works with Apache 2.0.39, don't use any other version of Apache with
PHP 4.2.3. However, the recommended setup is to use PHP 4.3.0 or later with
the most recent version of Apache2.
<br />
All mentioned versions of PHP will work still with
Apache 1.3.x.
<br />
</p></blockquote>
<p class="para">
The most receive version of Apache HTTP Server may be obtained from
<a href="http://httpd.apache.org/" class="link external">» Apache download site</a>,
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
<a href="http://httpd.apache.org/docs/2.2/" class="link external">» Apache Documentation</a>.
The version numbers have been omitted here, to ensure the
instructions are not incorrect. In the examples below, 'NN' should be
replaced with the specific version of Apache being used.
</p>
<p class="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.
</p>
<div class="example">
<p><b>Example #1
Installation Instructions (Apache 2 Shared Module Version)
</b></p>
<div class="example-contents screen">
<div class="cdata"><pre>
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_x_NN
6. ./configure --enable-so
7. make
8. make install
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.:
/usr/local/apache2/bin/apachectl start
and stop the server to go on with the configuration for PHP:
/usr/local/apache2/bin/apachectl stop.
9. cd ../php-NN
10. Now, configure your PHP. This is where you customize your PHP
with various options, like which extensions will be enabled. Do a
./configure --help for a list of available options. In our example
we'll do a simple configure with Apache 2 and MySQL support. Your
path to apxs may differ, in fact, the binary may even be named apxs2 on
your system.
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql
11. make
12. make install
If you decide to change your configure options after installation,
you only need to repeat the last three steps. You only need to
restart apache for the new module to take effect. A recompile of
Apache is not needed.
Note that unless told otherwise, 'make install' will also install PEAR,
various PHP tools such as phpize, install the PHP CLI, and more.
13. Setup your php.ini
cp php.ini-development /usr/local/lib/php.ini
You may edit your .ini file to set PHP options. If you prefer having
php.ini in another location, use --with-config-file-path=/some/path in
step 10.
If you instead choose php.ini-production, be certain to read the list
of changes within, as they affect how PHP behaves.
14. Edit your httpd.conf to load the PHP module. The path on the right hand
side of the LoadModule statement must point to the path of the PHP
module on your system. The make install from above may have already
added this for you, but be sure to check.
LoadModule php5_module modules/libphp5.so
15. Tell Apache to parse certain extensions as PHP. For example, let's have
Apache parse .php files as PHP. Instead of only using the Apache AddType
directive, we want to avoid potentially dangerous uploads and created
files such as exploit.php.jpg from being executed as PHP. Using this
example, you could have any extension(s) parse as PHP by simply adding
them. We'll add .phtml to demonstrate.
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>
Or, if we wanted to allow .php, .php2, .php3, .php4, .php5, .php6, and
.phtml files to be executed as PHP, but nothing else, we'd use this:
<FilesMatch "\.ph(p[2-6]?|tml)$">
SetHandler application/x-httpd-php
</FilesMatch>
And to allow .phps files to be handled by the php source filter, and
displayed as syntax-highlighted source code, use this:
<FilesMatch "\.phps$">
SetHandler application/x-httpd-php-source
</FilesMatch>
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
- OR -
service httpd restart
</pre></div>
</div>
</div>
<p class="para">
Following the steps above you will have a running Apache2 web server with
support for PHP as a <i>SAPI</i> module. Of course there are
many more configuration options available Apache and PHP. For more
information type <strong class="command">./configure --help</strong> in the corresponding
source tree.
</p>
<p class="para">
Apache may be built multithreaded by selecting the
<var class="filename">worker</var> MPM, rather than the standard
<var class="filename">prefork</var> MPM, when Apache is built. This is done by
adding the following option to the argument passed to ./configure, in
step 6 above:
</p>
<div class="example">
<div class="example-contents screen"><br />
--with-mpm=worker<br />
</div>
</div>
<p class="para">
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 <a href="http://httpd.apache.org/docs/2.2/mpm.html" class="link external">» MPM-Modules</a>
discusses MPMs in a great deal more detail.
</p>
<blockquote><p><b class="note">Note</b>:
The <a href="faq.installation.php#faq.installation.apache.multiviews" class="link">Apache MultiViews
FAQ</a> discusses using multiviews with PHP.
<br />
</p></blockquote>
<blockquote><p><b class="note">Note</b>:
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 default
<var class="filename">prefork</var> MPM-Module.
<br />
</p></blockquote>
</div><?php manual_footer(); ?>
