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.<\/p>\n
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.<\/p>\n
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:<\/p>\n
# Update package metadata and install software properties common\nsudo apt update && sudo apt install -y software-properties-common ca-certificates lsb-release apt-transport-https\n\n# Add the official Ondrej Sury PHP repository\nsudo add-apt-repository ppa:ondrej\/php -y\nsudo apt update<\/code><\/pre>\nStep 2: Installing Coexisting PHP Versions with Essential Extensions<\/h2>\n
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:<\/p>\n
# Install PHP 7.4, 8.1, 8.2, and 8.3 with high-performance FPM sockets\nsudo 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\n\n# Verify all four PHP-FPM systemd services are active and running\nsudo systemctl status php7.4-fpm php8.1-fpm php8.2-fpm php8.3-fpm --no-pager<\/code><\/pre>\nStep 3: Managing Global CLI Default PHP Version<\/h2>\n
When running command-line utilities, Composer builds, or global cron jobs, Ubuntu uses symbolic links managed by the update-alternatives<\/code> subsystem. To switch your default command-line PHP binary interactively or programmatically:<\/p>\n# Interactive selection modal\nsudo update-alternatives --config php\n\n# Programmatic instant switch to PHP 8.3 for CLI\nsudo update-alternatives --set php \/usr\/bin\/php8.3\nsudo update-alternatives --set phar \/usr\/bin\/phar8.3\nsudo update-alternatives --set phar.phar \/usr\/bin\/phar.phar8.3\n\n# Confirm active CLI runtime\nphp -v<\/code><\/pre>\nStep 4: Nginx Multi-PHP Virtual Host Routing Configuration<\/h2>\n
In Nginx, multi-PHP isolation is achieved by directing fastcgi_pass<\/code> directives to the specific Unix domain socket created by each PHP-FPM pool in \/run\/php\/<\/code>. Here is how to configure separate virtual hosts for different PHP runtimes:<\/p>\n# Virtual Host 1: Modern App running PHP 8.3 (\/etc\/nginx\/sites-available\/modern.example.com)\nserver {\n listen 80;\n server_name modern.example.com;\n root \/var\/www\/modern.example.com\/public;\n index index.php index.html;\n\n location \/ {\n try_files $uri $uri\/ \/index.php?$query_string;\n }\n\n location ~ \\.php$ {\n include snippets\/fastcgi-php.conf;\n fastcgi_pass unix:\/run\/php\/php8.3-fpm.sock;\n }\n}\n\n# Virtual Host 2: Legacy Portal running PHP 7.4 (\/etc\/nginx\/sites-available\/legacy.example.com)\nserver {\n listen 80;\n server_name legacy.example.com;\n root \/var\/www\/legacy.example.com\/public_html;\n index index.php index.html;\n\n location \/ {\n try_files $uri $uri\/ \/index.php?$query_string;\n }\n\n location ~ \\.php$ {\n include snippets\/fastcgi-php.conf;\n fastcgi_pass unix:\/run\/php\/php7.4-fpm.sock;\n }\n}<\/code><\/pre>\nStep 5: Apache Multi-PHP Virtual Host Routing Configuration<\/h2>\n
If you are utilizing the Apache web server, ensure mod_proxy<\/code> and mod_proxy_fcgi<\/code> are enabled, and route each VirtualHost using SetHandler<\/code>:<\/p>\n# Enable required Apache proxy modules\nsudo a2enmod proxy proxy_fcgi\nsudo systemctl restart apache2\n\n# Virtual Host config for PHP 8.2 (\/etc\/apache2\/sites-available\/app82.conf)\n<VirtualHost *:80>\n ServerName app82.example.com\n DocumentRoot \/var\/www\/app82\n <Directory \/var\/www\/app82>\n AllowOverride All\n Require all granted\n <\/Directory>\n <FilesMatch \\.php$>\n SetHandler \"proxy:unix:\/run\/php\/php8.2-fpm.sock|fcgi:\/\/localhost\"\n <\/FilesMatch>\n<\/VirtualHost><\/code><\/pre>\nComprehensive Multi-PHP Feature & Resource Matrix<\/h2>\n