How to Install and Switch Multiple PHP Versions on Ubuntu VPS (Apache & Nginx)

Why Multi-PHP Environments Are Crucial for Production VPS Servers

Modern web infrastructure frequently requires running legacy web applications alongside modern PHP frameworks. While modern applications like Laravel 11 or Symfony 7 demand PHP 8.2 or 8.3 with JIT compilation and strict typing, older legacy enterprise applications, custom client portals, and older WordPress plugin suites may still require PHP 7.4 or PHP 8.1. Running multiple simultaneous PHP versions on a single high-performance Linux VPS allows you to isolate application dependencies, prevent breaking updates, and optimize server resource utilization without requiring costly separate VPS instances.

In this comprehensive enterprise tutorial, we will walk step-by-step through configuring Ondrej Sury’s official PHP PPA repository on Ubuntu, installing PHP 7.4, 8.1, 8.2, and 8.3 with production-grade FPM (FastCGI Process Manager) extensions, managing global CLI defaults via Debian alternatives, and configuring virtual host routing across both Nginx and Apache web servers.

Step 1: Adding Ondrej Sury’s Production PHP PPA Repository

Ubuntu’s default universe repository only packages a single fixed version of PHP corresponding to the Ubuntu release version (e.g., PHP 8.1 on Ubuntu 22.04 LTS or PHP 8.3 on Ubuntu 24.04 LTS). To access all active and legacy PHP branches, we add the trusted and signed Ondrej Sury PPA repository:

# Update package metadata and install software properties common
sudo apt update && sudo apt install -y software-properties-common ca-certificates lsb-release apt-transport-https

# Add the official Ondrej Sury PHP repository
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update

Step 2: Installing Coexisting PHP Versions with Essential Extensions

For production deployments, we always install PHP-FPM alongside standard core modules including MySQL drivers, cURL, MBString, XML, GD image manipulation, Zip, BCMath, and OPcache. Execute the following bulk installation command to deploy PHP 7.4, 8.1, 8.2, and 8.3:

# Install PHP 7.4, 8.1, 8.2, and 8.3 with high-performance FPM sockets
sudo apt install -y   php7.4-fpm php7.4-cli php7.4-mysql php7.4-curl php7.4-mbstring php7.4-xml php7.4-zip php7.4-gd php7.4-bcmath php7.4-opcache   php8.1-fpm php8.1-cli php8.1-mysql php8.1-curl php8.1-mbstring php8.1-xml php8.1-zip php8.1-gd php8.1-bcmath php8.1-opcache   php8.2-fpm php8.2-cli php8.2-mysql php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip php8.2-gd php8.2-bcmath php8.2-opcache   php8.3-fpm php8.3-cli php8.3-mysql php8.3-curl php8.3-mbstring php8.3-xml php8.3-zip php8.3-gd php8.3-bcmath php8.3-opcache

# Verify all four PHP-FPM systemd services are active and running
sudo systemctl status php7.4-fpm php8.1-fpm php8.2-fpm php8.3-fpm --no-pager

Step 3: Managing Global CLI Default PHP Version

When running command-line utilities, Composer builds, or global cron jobs, Ubuntu uses symbolic links managed by the update-alternatives subsystem. To switch your default command-line PHP binary interactively or programmatically:

# Interactive selection modal
sudo update-alternatives --config php

# Programmatic instant switch to PHP 8.3 for CLI
sudo update-alternatives --set php /usr/bin/php8.3
sudo update-alternatives --set phar /usr/bin/phar8.3
sudo update-alternatives --set phar.phar /usr/bin/phar.phar8.3

# Confirm active CLI runtime
php -v

Step 4: Nginx Multi-PHP Virtual Host Routing Configuration

In Nginx, multi-PHP isolation is achieved by directing fastcgi_pass directives to the specific Unix domain socket created by each PHP-FPM pool in /run/php/. Here is how to configure separate virtual hosts for different PHP runtimes:

# Virtual Host 1: Modern App running PHP 8.3 (/etc/nginx/sites-available/modern.example.com)
server {
    listen 80;
    server_name modern.example.com;
    root /var/www/modern.example.com/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

# Virtual Host 2: Legacy Portal running PHP 7.4 (/etc/nginx/sites-available/legacy.example.com)
server {
    listen 80;
    server_name legacy.example.com;
    root /var/www/legacy.example.com/public_html;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
}

Step 5: Apache Multi-PHP Virtual Host Routing Configuration

If you are utilizing the Apache web server, ensure mod_proxy and mod_proxy_fcgi are enabled, and route each VirtualHost using SetHandler:

# Enable required Apache proxy modules
sudo a2enmod proxy proxy_fcgi
sudo systemctl restart apache2

# Virtual Host config for PHP 8.2 (/etc/apache2/sites-available/app82.conf)
<VirtualHost *:80>
    ServerName app82.example.com
    DocumentRoot /var/www/app82
    <Directory /var/www/app82>
        AllowOverride All
        Require all granted
    </Directory>
    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost"
    </FilesMatch>
</VirtualHost>

Comprehensive Multi-PHP Feature & Resource Matrix

Production Best Practices for Multi-PHP Server Tuning

• Tune pm.max_children Per Pool: Calculate your RAM budget carefully. If you run 4 PHP-FPM pools, divide your available memory (e.g., 4GB RAM) so that idle pools do not trigger Linux OOM killer panic.
• Enable OPcache JIT on PHP 8.2/8.3: Set opcache.jit=tracing and opcache.jit_buffer_size=128M in /etc/php/8.3/fpm/php.ini for peak computational throughput.
• Isolate Log Files: Configure distinct error logs in /var/log/php7.4-fpm.log and /var/log/php8.3-fpm.log for rapid debugging.
• Harden php.ini Directives: Enforce expose_php = Off, display_errors = Off, and max_execution_time = 60 across all installed versions.