Debian中PHP版本如何切换

在Debian系统上管理多个PHP版本，是不少开发者和运维人员都会遇到的场景。特别是当手头有多个项目，对PHP版本要求各不相同时，如何在命令行和Web服务之间流畅切换，就成了一个必须掌握的技能。下面就把这套流程拆开揉碎了说说。

先说几个核心判断：这事儿并不复杂，关键在于分清CLI和Web服务是两个独立的“赛道”，需要分别处理。另外，Debian官方仓库提供的PHP版本通常比较保守，想在同一台机器上安装多个版本，就得借助第三方源。

一、准备工作：让多个PHP版本共存在一台机器上

先把基础工具装好，这步是给后面铺路：

sudo apt update && sudo apt install -y ca-certificates lsb-release apt-transport-https

接下来，要引入一个在PHP社区里口碑不错的第三方仓库——SURY。它几乎覆盖了从PHP 5.6到8.x的所有主流版本，是让多版本共存的理想选择。

添加仓库的步骤也简单，先导入密钥，再把源地址写进去：

wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

仓库准备好了，就可以安装你想要的PHP版本了。比如我们要装PHP 8.2和7.4，并且考虑到后续可能会用Nginx+PHP-FPM，顺手把对应的fpm包也装上：

sudo apt install -y php8.2 php8.2-cli php8.2-fpm
sudo apt install -y php7.4 php7.4-cli php7.4-fpm

完成后，可以用ls /usr/bin/php*和php -v确认一下二进制文件都在。

这个阶段的目标就一个：让不同的PHP版本在系统里“和平共处”，为后面的切换打好基础。

二、切换CLI版本：影响的是你在命令行里的“默认选择”

命令行下默认的PHP版本，是通过update-alternatives这个机制来管理的。我们可以把它理解为系统里的“版本仲裁者”。

首先，把两个PHP版本注册为候选，并指定优先级（数值越大，优先级越高）：

sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82
sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74

现在可以用交互模式手动选择默认版本：

sudo update-alternatives --config php

或者，如果你清楚自己要什么，直接指定也行：

sudo update-alternatives --set php /usr/bin/php8.2

最后用php -v验证一下。需要牢记的是，这一步只改变php命令在终端里的表现，它跟后面要讲的Web服务是两回事。

三、切换Web服务版本：核心是让Apache或Nginx指向正确的PHP

Web服务的切换逻辑，取决于你用的是Apache还是Nginx。这两条路要分清楚。

如果用的是Apache + mod_php：

那就用a2enmod和a2dismod来启用或禁用对应版本的模块。比如要把当前PHP 7.4换成8.2：

sudo a2dismod php7.4
sudo a2enmod php8.2
sudo systemctl restart apache2

重启Apache后，模块就生效了。

如果用的是Nginx + PHP-FPM：

方式略有不同。首先需要通过a2enconf/a2disconf（注意，这是Debian 12及之后的推荐做法）来切换启用的FPM池：

sudo a2enconf php8.2-fpm
sudo a2disconf php7.4-fpm
sudo systemctl restart php8.2-fpm
sudo systemctl reload nginx

这里有一个容易踩坑的地方：Nginx站点配置文件里的fastcgi_pass参数，必须指向当前启用的FPM版本的监听地址（比如/run/php/php8.2-fpm.sock）。如果指向错了，Nginx就会报502。

验证Web端版本的方法很简单：在网站根目录下放一个phpinfo文件，通过浏览器访问，确认显示的版本和SAPI类型和你切换的目标一致。

四、扩展与配置：别忘了每个版本都是“独立王国”

多个PHP版本共存，意味着每个版本都有自己的扩展和配置文件，互不干扰。

安装扩展时一定要带上版本号，避免装错：

sudo apt install -y php8.2-mysql php8.2-curl php8.2-mbstring
sudo apt install -y php7.4-mysql php7.4-curl php7.4-mbstring

配置文件也按版本和SAPI分开放置。比如Apache模式用的php.ini在/etc/php/8.2/apache2/，而FPM模式的则在/etc/php/8.2/fpm/。修改之后，记得重启对应的服务（apache2或phpX.Y-fpm）才会生效。

五、验证与排错：确保切换落地

切换完成后，最好从头到尾检查一遍：

• CLI版本：php -v和which php结果是否一致？
• 注册的候选版本：update-alternatives --list php有没有遗漏？
• 已安装版本目录：ls /etc/php里包含哪些版本？

如果遇到问题，最常见的有三种：

CLI和Web版本不一致——分别检查并按照第二、三节的操作重新切换即可，两者互不依赖。

扩展不可用——确认你安装的扩展包版本号是否与当前使用的PHP版本匹配。错了就重装对应版本的扩展，然后重启服务。

切换后出现502或空白页——大概率是FPM没启动，或者Nginx的fastcgi_pass指向了错误的sock文件。检查phpX.Y-fpm状态和Nginx配置，对齐就行。