PHP多版本共存配置教程

首先安装多个PHP版本并配置update-alternatives实现CLI切换，再分别设置Apache模块或Nginx与PHP-FPM协同工作以支持Web环境多版本共存。

如果您需要在同一台服务器上运行多个基于PHP开发的项目，而这些项目依赖于不同版本的PHP，则可能遇到版本冲突问题。通过使用update-alternatives工具，可以方便地在Linux系统中实现PHP多版本共存与快速切换。

本文运行环境：Dell PowerEdge R750，Ubuntu 22.04

一、安装多个PHP版本

在配置多版本共存前，需确保系统中已安装至少两个不同版本的PHP。可通过第三方仓库如Ondrej PHP PPA来获取多个版本的支持。

1、执行命令添加PPA源：sudo add-apt-repository ppa:ondrej/php。

2、更新软件包列表：sudo apt update。

3、安装PHP 7.4：sudo apt install php7.4 php7.4-cli。

4、安装PHP 8.1：sudo apt install php8.1 php8.1-cli。

5、可选：安装其他版本如php8.2或php7.3以满足更多需求。

二、配置update-alternatives管理PHP CLI

update-alternatives是Debian系系统中用于管理同一功能不同版本命令行工具的机制。通过它可设置默认的php命令指向哪个版本。

1、注册PHP 7.4为update-alternatives选项：sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74。

2、注册PHP 8.1为update-alternatives选项：sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81。

3、数字参数74和81代表优先级，数值越高默认优先级越高。

三、切换PHP CLI版本

完成注册后，可通过交互式命令选择当前系统默认使用的PHP版本。

1、运行切换命令：sudo update-alternatives --config php。

2、终端将列出所有可用PHP版本，并提示输入编号进行选择。

3、输入对应编号后，系统将软链接/usr/bin/php指向所选版本。

4、验证当前版本：php -v，确认输出符合预期。

四、配置Apache使用指定PHP版本

若使用Apache作为Web服务器，需单独配置其加载的PHP模块，因update-alternatives不自动处理Web服务集成。

1、禁用当前PHP模块，例如关闭PHP 8.1：sudo a2dismod php8.1。

2、启用目标版本模块，如启用PHP 7.4：sudo a2enmod php7.4。

3、重启Apache服务使配置生效：sudo systemctl restart apache2。

4、创建info.php文件放入Web目录，内容为，通过浏览器访问验证模块版本。

五、配置Nginx与PHP-FPM共存

Nginx本身不解析PHP，需配合PHP-FPM进程管理器。每个PHP版本可运行独立FPM服务，通过端口或socket区分。

1、启动PHP 7.4 FPM服务：sudo systemctl start php7.4-fpm。

2、启动PHP 8.1 FPM服务：sudo systemctl start php8.1-fpm。

3、编辑Nginx站点配置，指定fastcgi_pass指向不同.sock文件或端口，例如对某个域名使用unix:/var/run/php/php7.4-fpm.sock。

4、重载Nginx配置：sudo systemctl reload nginx。