Configure Apache to work with PHP4 and PHP5

1.  Introduction

There are many ways to make Apache work with two PHP versions in parallel. The easiest way is to use PHP4 and PHP5 as a CGI binary, or PHP4 as CGI binary and PHP5 as Apache module (or the other way around). In this Howto Apache-2.x paths are used, but it will work with Apache-1.x paths as well (generally, just omit the 2).

For instructions how to upgrade your old dev-php/php to the new dev-lang/php packages, have a look at the Upgrade Guide.

2.  Alternative 1: PHP4 CGI and PHP5 CGI

Install PHP4 and PHP5

Add cgi and force-cgi-redirect USE flag to /etc/portage/package.use:

=dev-lang/php-4* cgi force-cgi-redirect
=dev-lang/php-5* cgi force-cgi-redirect

Emerge PHP4 and PHP5:

emerge '=dev-lang/php-4*' '=dev-lang/php-5*'

Global/Default Configuration for PHP4 CGI

Requests to files ending with .php, .php3, .php4 or .phtml should be handled by PHP4 CGI (this can be easily changed). Create a /etc/apache2/modules.d/php4-cgi.conf, which will be included by httpd.conf automatically:

# handler for PHP 4 scripts
<IfDefine PHP4CGI>
    ScriptAlias /php4-cgi /usr/lib/php4/bin/php-cgi	
    Action php4-cgi /php4-cgi
    AddHandler php4-cgi .php4 .php3 .php .phtml
</IfDefine>

Global/Default Configuration for PHP5 CGI

Requests to files ending with .php5 should be handled by PHP5 CGI (this can be easily changed). Create a /etc/apache2/modules.d/php5-cgi.conf, which will be included by httpd.conf automatically:

# handler for PHP 5 scripts
<IfDefine PHP5CGI>
    ScriptAlias /php5-cgi /usr/lib/php5/bin/php-cgi	
    Action php5-cgi /php5-cgi
    AddHandler php5-cgi .php5
</IfDefine>

Per Directory/VHost Configuration of PHP version

You can use a <VirtualHost>, <Location>, <Directory> directive or even a .htaccess file to configure handling of scripts ending with .php to use either PHP4 CGI or PHP5 CGI, depending on where the script is located. Use the AddHandler directive to select the PHP versions to handle the requests:

<VirtualHost *:80>

    DocumentRoot  /var/www/example.com/htdocs
    ServerName www.example.com

    <Location /php4>
    	AddHandler php4-cgi .php
    </Location>

    <Location /php5>
    	AddHandler php5-cgi .php
    </Location>

</VirtualHost>

<VirtualHost *:80>

    DocumentRoot /var/www/example.com/htdocs
    ServerName www.example.com

    <Directory /var/www/example.com/htdocs/php4>
    	AddHandler php4-cgi .php
    </Directory>

    <Directory /var/www/example.com/htdocs/php5>
    	AddHandler php5-cgi .php
    </Directory>

</VirtualHost>

This way you can configure Apache which PHP handler to use for every location or directory!

set APACHE2_OPTS

By using the APACHE2_OPTS variable in /etc/conf.d/apache2 you can easily configure Apache to handle PHP4 and PHP5 as CGIs now:

APACHE2_OPTS="-D PHP4CGI -D PHP5CGI"

3.  Alternative 2: PHP4 CGI and PHP5 Apache module

Install PHP4 and PHP5

Add cgi and force-cgi-redirect USE flag for PHP4 and apache2 for PHP5 to /etc/portage/package.use:

=dev-lang/php-4* cgi force-cgi-redirect
=dev-lang/php-5* apache2

Emerge PHP4 and PHP5:

emerge '=dev-lang/php-4*' '=dev-lang/php-5*'

Global/Default Configuration for PHP4 CGI

Requests to files ending with .php3, .php4 or .phtml should be handled by PHP4 CGI (this can be easily changed). Create a /etc/apache2/modules.d/php4-cgi.conf, which will be included by httpd.conf automatically:

# handler for PHP 4 scripts
<IfDefine PHP4CGI>
    ScriptAlias /php4-cgi /usr/lib/php4/bin/php-cgi	
    Action php4-cgi /php4-cgi
    AddHandler php4-cgi .php4 .php3 .php .phtml
</IfDefine>

Global/Default Configuration for PHP5 module

If the PHP ebuild installs an Apache module, it will also automatically install a configuration file to /etc/apache2/modules.d/70_mod_php5.conf.

Requests to files ending with .php5, as well as files ending with .phps (PHP source files), will be handled by the PHP5 Apache module (this can be easily changed).

To achieve this, you need to edit the default configuration file and make it look like this:

<IfDefine PHP5>

    # Load the module first 
    <IfModule !sapi_apache2.c>
        LoadModule php5_module    modules/libphp5.so 
    </IfModule>

    # Set it to handle the files 
    <IfModule mod_mime.c>
        AddType application/x-httpd-php .php5 
        AddType application/x-httpd-php-source .phps 
    </IfModule>

    AddDirectoryIndex index.php index.phtml 
</IfDefine>

Per Directory/VHost Configuration of PHP version

You can use a <VirtualHost>, <Location>, <Directory> directive or even a .htaccess file to configure handling of scripts ending with .php to use either PHP4 CGI or PHP5 module, depending on where the script is located. Use the AddHandler directive to select the PHP versions to handle the requests:

<VirtualHost *:80>

    DocumentRoot  /var/www/example.com/htdocs
    ServerName www.example.com

    <Location /php4>
    	AddHandler php4-cgi .php
    </Location>

    <Location /php5>
    	AddHandler application/x-httpd-php .php
    </Location>

</VirtualHost>

<VirtualHost *:80>

    DocumentRoot /var/www/example.com/htdocs
    ServerName www.example.com

    <Directory /var/www/example.com/htdocs/php4>
    	AddHandler php4-cgi .php
    </Directory>

    <Directory /var/www/example.com/htdocs/php5>
    	AddHandler application/x-httpd-php .php
    </Directory>

</VirtualHost>

This way you can configure Apache which PHP handler to use for every location or directory!

set APACHE2_OPTS

By using the APACHE2_OPTS variable in /etc/conf.d/apache2 you can easily configure Apache to handle PHP4 as CGI and PHP5 as module now (or the other way around):

APACHE2_OPTS="-D PHP4CGI -D PHP5"

4.  Alternative 3: PHP4 and PHP5 CGI with suPHP

Install PHP4 and PHP5

Add cgi and force-cgi-redirect USE flag to /etc/portage/package.use:

=dev-lang/php-4* cgi force-cgi-redirect
=dev-lang/php-5* cgi force-cgi-redirect

Emerge PHP4 and PHP5:

emerge '=dev-lang/php-4*' '=dev-lang/php-5*'

Install mod_suphp

emerge mod_suphp

A few notes on it's USE flags:

Global/Default Configuration for PHP

By using the APACHE2_OPTS variable in /etc/conf.d/apache2 you can easily configure Apache to handle PHP4 and PHP5 through suPHP now:

APACHE2_OPTS="-D SUPHP"

Change PHP handler to handle requests to .php scripts

By default, requests to files ending with .php, .php5, or .phtml will be handled by PHP5 CGI and files ending with .php4 by PHP4 CGI. This can be easily changed in /etc/suphp.conf:

[handlers]
;Handler for php-scripts
x-httpd-php=php:/usr/lib/php4/bin/php-cgi
x-httpd-php5=php:/usr/lib/php5/bin/php-cgi
x-httpd-php4=php:/usr/lib/php4/bin/php-cgi
x-httpd-phtml=php:/usr/lib/php4/bin/php-cgi

The above example reverses the default mod_suphp handlers to use PHP4 by default, only files ending with .php5 will now be handled by PHP5 CGI.

5.  More Alternatives

In this guide we have focussed on the easiest alternatives to get PHP4 and PHP5 running in parallel. As mentioned before there are more alternatives. We will list some of them in this chapter, and point you to other sites where you can get more detailed information.

Running PHP4 and PHP5 module using 2 Apache instances

If you have one Apache installed, you can run two instances of it. You only need to create a second configuration file (httpd.conf) with different settings (e.g. load PHP5 module, not PHP4 module...). But you cannot bind 2 Apache instances to the same port-IP combination, so you have to use a different IP or port in the 2nd configuration file. At Apache startup you can use the -f switch to set the config file to use, which can be easily implemented by copying and changing the original RC script shipped with the Apache ebuild.

The basic steps to make it work on Gentoo:

• add apache2 USE flag to dev-lang/php entry in /etc/portage/package.use to install Apache2 modules
• install PHP4 and PHP5: emerge '=dev-lang/php-4*' '=dev-lang/php-5*'
• create a copy of /etc/apache2/httpd.conf for the 2nd Apache instance
• change port or IP the 2nd Apache instance will bind to
• load other PHP module
• make sure to use unique files (like LockFile...)
• copy /etc/init.d/apache2
• change the copied script to load new (copied and altered) httpd.conf for 2nd Apache instance

Further information:

• How to run PHP4 and PHP 5 prallel (Tobias Schlitt)

Hiding the 2nd Apache instance using mod_proxy

Basically it works the same as explained above, but solved the problem with using different IPs / ports: By using mod_proxy, you can use the reverse proxy functions to hide the 2nd Apache instance from users, by passing requests transparently to the 2nd Apache instance.

The basic steps to make it work on Gentoo:

• same as in previous chapter
• enable mod_proxy in primary webserver (usually listening to default IP, port 80/443)
• use the ProxyPass directive or the [P] flag to the RewriteRule directive to forward requests which need the other PHP module

Further information:

• Multiple Apache Installations HOWTO (Derick Rethans)
• Running PHP 4 and PHP 5 Concurrently (John Coggeshall)
• Apache Module mod_proxy (Apache docs)
• RewriteRule Directive (Apache docs)

Using FastCGI

FastCGI is another alternative, which is as fast as or faster than a PHP module and does not suffer from threading issues (like PHP module if used with a threaded Apache MPM like "worker"), because it's not embedded in the webserver process.

The basic steps to make it work on Gentoo:

• add cgi and force-cgi-redirect USE flag to dev-lang/php entry in /etc/portage/package.use to install CGI version of PHP (includes FastCGI support)
• install PHP4 and PHP5: emerge '=dev-lang/php-4*' '=dev-lang/php-5*'
• follow instructions in howtos below

Further information:

• mod_fastcgi (FastCGI module for Apache)
• mod_fcgid (alternative FastCGI module for Apache)
• Apache Mod Fastcgi PHP (alternative to CGI/SuPHP)
• lighttpd FastCGI module (lightweight webserver with easy to configure FastCGI support)

6.  Restart Apache

After the installation and configuration please don't forget to restart your Apache to load the new configuration:

/etc/init.d/apache2 restart

The contents of this document are licensed under the Creative Commons - Attribution / Share Alike license.