Multiple PHP versions on Apache Server Ubuntu

5
(3)

The Apache web server provides virtual hosts using different PHP versions to support multiple domains on a single Ubuntu server. You can manage multiple PHP versions on the same web server.

Apache WebserverMultiple PHP versions on Apache Server Ubuntu

Together, with Apache and PHP-FPM to hosting multiple PHP web-applications, each using a different version of PHP, all on the same server, and all at the same time. This because different applications may require different versions of PHP, but some server stacks, like a regularly configured LAMP stack, can only manage one. Using Apache with PHP-FPM FastCGI Process Manager is also a more cost-efficient solution than hosting each application on its own instance.

In this tutorial you’ll learn how to deploy two PHP sites on a single Ubuntu 20.04 or 22.04 server. Each site will use its own domain, and each domain use its own version of PHP. The first, site1.example.com will use PHP 8.2. The second, site2.example.com use PHP 7.4.

Step 1 – Installing PHP Version 8.2 with PHP-FPM

After the requirements are met, install PHP versions 7.4 and 8.2 as well as PHP-FPM and several additional extensions. To achieve this, we first add the ondrej/php PPA to the Ubuntu server.

Install PHP with the Apache module. Below you will find installations for both PHP 7.4 and PHP 8.2. First of all, bring the system up to date.

$ sudo apt update && sudo apt upgrade -y

Next, the required service packages are installed.

$ sudo apt install lsb-release apt-transport-https ca-certificates wget gnupg software-properties-common -y

If the package is already available, continue to the next step.

Next, add the ondrej/php PPA which provides different PHP versions for Ubuntu Linux.

$ sudo add-apt-repository ppa:ondrej/php

Press Enter to confirm adding the repository. The available PHP versions in the PPA are from 5.6 up to 8.2.

Update apt to include the new packages.

$ sudo apt update

Install the Apache web server it is not already done.

$ sudo apt install apache2 -y

Now install PHP 8.2 and PHP-FPM together with the most important PHP modules.

$ sudo apt install php8.2 php8.2-fpm php8.2-{cli,mysql,imap,intl,apcu,cgi,bz2,zip,mbstring,gd,curl,xml,common,opcache,imagick} -y

Next install Apache module for PHP-FPM FastCGI Process Manager.

$ sudo apt install libapache2-mod-fcgid -y

Step 2 – Installing PHP Version 7.4 with PHP-FPM

Next step repeat the process for PHP version 7.4 with PHP-FPM.

$ sudo apt install php7.4 php7.4-fpm php7.4-{cli,mysql,imap,intl,apcu,cgi,bz2,zip,mbstring,gd,curl,xml,common,opcache,imagick} -y

quote  Note. the libapache2-mod-fcgid package is already installed in step 1.

Update the packages as follows.

$ sudo apt update && sudo apt upgrade -y
$ [ -f /run/reboot-required ] && sudo reboot -f

With installing two PHP versions, start the php8.2-fpm service.

$ sudo systemctl start php8.2-fpm

Repeating this process, now start the php7.4-fpm service.

$ sudo systemctl start php7.4-fpm

Now check the status of the php-fpm services.

$ sudo systemctl status php*

Step 3 – Configure Apache for Multiple PHP-FPM versions

Finaly, enable several modules using the Apache helper command so that your Apache2 service work with multiple PHP versions.

$ sudo a2enmod actions fcgid alias proxy_fcgi setenvif

Now restart the Apache service to apply your changes.

$ sudo systemctl restart apache2

With this steps you have installed two PHP versions on your server. Next, you’ll create a docroot for each website you want to deploy.

Step 4 – Creating Docroot for 2 Apache Websites

In this step, you will create a document root directory and an index page for each of your two websites.

First, create document root directories for site1.example.com and site2.example.com. This you can do with copy & paste the following for loop command in the bash.

$ sudo for i in {1..2}; do mkdir /var/www/site"$i".example.com ;done

quote These for loop should work in all common shells, bash and zsh offer an abbreviated version by perform mkdir site{1..2}.example.com

By default, the Apache webserver runs as a www-data user and www-data group. To ensure that you have the correct ownership and permissions of your website root directories. This can be performed with the following for loop commands in the bash.

$ sudo for i in {1..2}; do chown -R www-data:www-data /var/www/site"$i".example.com ;done
$ sudo for i in {1..2}; do chmod -R 755 /var/www/site"$i".example.com ;done

Next you’ll create an phpinfo.php file inside each website document root. This will display each website’s PHP version information. Now let’s begin with site1.

Create the phpinfo.php file with copy & paste the following command.

$ sudo for i in {1..2}; do echo -e "<?php phpinfo(); ?>" > /var/www/site"$i".example.com/phpinfo.php ;done

The web server should now have the document root directories that each site requires to serve data to visitors. Next, you will configure the Apache web server to work with two different PHP versions.

Step 5 – Configuring Apache for Both Websites

In this step, you’ll create two Apache virtual host configuration files. This will enable your two websites to work simultaneously with two different PHP versions.

In order for Apache to serve this content, it is necessary to create a virtual host file that contains the needed directives. Instead of modifying the default configuration file located at /etc/apache2/sites-available/000-default.conf, you’ll create two new ones inside the directory /etc/apache2/sites-available/.

First create a new Apache virtual host configuration file for the website site1.mydomain. Here you will direct Apache to render content using php8.2.

$ sudo vi /etc/apache2/sites-available/site1.example.com.conf

quote Use the editor of your choice, maybe it’s nano, it’s possible for old dudes who can’t replace the heavy rock VIM with anything!

Add the following content. Make sure the website DocumentRoot path, ServerName, and PHP version match your setup.

<VirtualHost *:80>
     ServerAdmin admin@site1.example.com
     ServerName site1.example.com
     DocumentRoot /var/www/site1.example.com
     DirectoryIndex phpinfo.php

     <Directory /var/www/site1.example.com>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
     </Directory>

    <FilesMatch \.php$>
      # For Apache version 2.4.10 and above, use SetHandler to run PHP as a fastCGI process server
      SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost"
    </FilesMatch>

     ErrorLog ${APACHE_LOG_DIR}/site1.example_error.log
     CustomLog ${APACHE_LOG_DIR}/site1.example_access.log combined
</VirtualHost>

In this file you updated the DocumentRoot to your new directory and ServerAdmin to an email that the mydomain site administrator can access. You’ve also updated ServerName, which establishes the base domain for this virtual host configuration, and you’ve added a SetHandler directive to run PHP as a FastCGI Process Manager.

Save and close the file.

Next, create a new virtual host configuration file for the website site2.mydomain. You will specify this subdomain to deploy php7.4.

$ sudo vi /etc/apache2/sites-available/site2.example.com.conf

Add the following content. Again, make sure the website directory path, ServerName, and PHP version match your unique information.

<VirtualHost *:80>
     ServerAdmin admin@site2.example.com
     ServerName site2.example.com
     DocumentRoot /var/www/site2.example.com
     DirectoryIndex phpinfo.php

     <Directory /var/www/site2.example.com>
        Options Indexes FollowSymLinks MultiViews
        Require all granted
     </Directory>

    <FilesMatch \.php$>
      # For Apache version 2.4.10 and above, use SetHandler to run PHP as a fastCGI process server
      SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost"
    </FilesMatch>

     ErrorLog ${APACHE_LOG_DIR}/site2.example_error.log
     CustomLog ${APACHE_LOG_DIR}/site2.example_access.log combined
</VirtualHost>

Save and close the file when you are finished. Then check the Apache configuration file for any syntax errors.

$ sudo apachectl configtest

You’ll see the following output.

Syntax OK

Next, enable both virtual host configuration files.

$ sudo a2ensite site1.example.com
$ sudo a2ensite site2.example.com

Now disable the default site, since you won’t need it.

$ sudo a2dissite 000-default.conf

Finally, restart the Apache service to implement your changes.

$ sudo systemctl restart apache2

Now that you have configured Apache to serve each site, you will test them to make sure the proper PHP versions are running.

Step 6 – Testing Websites using Apache with PHP-FPM versions

At this step, you have configured two Apache websites to run two different versions of PHP.

Testing PHP-FPM version using phpinfo()

Open your web browser and visit the sites http://site1.example.com and http://site2.example.com. You will see pages look like this.

Multiple PHP versions on Apache Server Ubuntu
phpinfo Version 8.2.14 FPM/FastCGI

Note. The page indicates that site1.example.com deployed PHP version 8.2.

PHP settings using FPM/FastCGI you can find the php.ini file under the path /etc/php/{version}/fpm/php.ini like /etc/php/8.2/fpm/php.ini.

To enable FastCGI – PHP-FPM you can also use these commands.

$ sudo a2enmod proxy_fcgi setenvif
$ sudo a2enconf php8.2-fpm
$ sudo systemctl restart apache2

The default configuration works for most of the installation, however it could be improved in various ways. To re-enable it’s recommended to enable access to the files only in specific virtual host or directory.

Find further examples at https://wiki.apache.org/httpd/PHP-FPM

Step 7 – Finally, clean up no needed files

Now that you’ve tested your sites, remove the phpinfo.php files. Because they contain sensitive information about your server and are accessible to unauthorized users, they pose a security threat. To remove both files and directory perform the following command.

$ sudo for i in {1..2}; do rm -rf /var/www/site"$i".example.com ;done

You now learn how to deploy a single Ubuntu 20.04 or 22.04 server handling two websites with two different PHP versions. PHP-FPM, however, is not limited to two PHP versions only.

Conclusion

You have now combined Apache virtual hosts and PHP-FPM to serve multiple websites and multiple versions of PHP on a single Ubuntu server. The only practical limit on the number of PHP sites and PHP versions that your Apache service can handle is the processing power of your instance.

From here you might consider exploring PHP-FPM’s more advanced FastCGI Process Manager features, like its adaptive spawning process or how it can log sdtout and stderr. Alternatively, you could now secure your websites.

How useful was this post?

Click on a star to rate it!

Average rating 5 / 5. Vote count: 3

No votes so far! Be the first to rate this post.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Leave a Reply

Your email address will not be published. Required fields are marked *