在 PHP 8 多版本共存环境中，切换默认 CLI 版本的核心在于修改系统环境变量或软链接，例如执行 sudo update-alternatives --config php 可将命令行版本精准切换至 PHP 8.1.12 等特定版本。

原因分析

CLI 与 FPM 版本不一致的核心原因是两者属于独立的运行单元。根据 2026 年 3 月 5 日发布的技术分析，CLI 版本由系统环境变量控制，调用 /usr/bin/php，而 FPM 版本由 Web 服务器配置决定，例如 Nginx 通过 fastcgi_pass 指向 unix:/run/php/php7.4-fpm.sock，导致出现「CLI 是 8.2，FPM 是 7.4」的不一致问题。

解决方案

方法一：使用 update-alternatives 管理（Linux 通用）

适用于 Ubuntu/Debian 系统。首先运行 sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81 注册版本，随后执行 sudo update-alternatives --config php 交互式选择编号。验证命令为 php -v，确保输出目标版本号（资料日期：2025 年 11 月 16 日）。

方法二：使用 phpenv 版本管理工具

适用于需要灵活切换的开发环境。先执行 phpenv install 8.1.12 安装目标版本，再运行 phpenv global 8.1.12 设置系统级默认。注意 phpenv global 不会覆盖当前已激活的 shell 版本，需新开终端或运行 source ~/.bashrc 刷新（资料日期：2026 年 4 月 23 日）。

方法三：宝塔面板可视化切换

登录宝塔面板后台，点击【网站】列表右侧【设置】，在【PHP 版本】选项卡中选择已安装的较新版本如 PHP 8.4。面板将自动重启该站点关联的 Web 服务与 PHP-FPM 进程，无需手动修改系统级配置（资料日期：2026 年 4 月 21 日）。

方法四：手动修改软链接

高级用户可直接控制 /usr/bin/php 指向。执行 rm -f /usr/bin/php 删除旧链接，再运行 ln -sf /www/server/php/81/bin/php /usr/bin/php 重建指向 PHP 8.1 的软链接。最后执行 source /etc/profile 刷新环境变量（资料日期：2026 年 1 月 10 日）。

注意事项

1. 避免 CLI 与 FPM 不一致：切换 CLI 后若 Web 服务仍报错，需检查 Nginx 配置是否仍指向旧版本 FPM Socket，如 php7.4-fpm.sock。

2. LNMP 环境配置陷阱：在 LNMP 模式下修改虚拟主机配置文件 /usr/local/nginx/conf/vhost/域名.conf 时，若将 include enable-php.conf; 替换为 include enable-php8.0.conf; 后未重启 Nginx，会直接提示 502 错误（资料日期：2023 年 4 月 20 日）。

3. phpenv 优先级问题：如果之前执行过 phpenv shell 7.4，当前会话仍用 7.4，直到退出或执行 phpenv shell --unset，global 设置不会立即生效（资料日期：2026 年 4 月 23 日）。

参考来源

来源：Linux 技术社区 - 多版本 PHP 共存下，CLI 与 FPM 版本不一致的终极解决方案（2026 年 3 月 5 日）

来源：phpEnv 官方文档 - phpenv 如何修改默认 PHP CLI 版本（2026 年 4 月 23 日）

来源：宝塔面板帮助中心 -PHP 版本太低怎么升级（2026 年 4 月 21 日）

来源：LNMP 官方论坛 - 玩转服务器 lnmp 多版本 PHP 安装及指定 PHP CLI 版本（2023 年 4 月 20 日）