本文详解如何同步更新命令行（CLI）和Web服务器（Apache）所用的PHP版本，解决php -v与phpinfo()显示不一致的问题，涵盖模块启用、替代方案配置及服务重启等关键步骤。
本文详解如何同步更新命令行（cli）和web服务器（apache）所用的php版本，解决`php -v`与`phpinfo()`显示不一致的问题，涵盖模块启用、替代方案配置及服务重启等关键步骤。
在Ubuntu系统中，php -v显示CLI版本而phpinfo()显示Apache所用版本——二者不同步是常见痛点。根本原因在于：PHP CLI和Apache模块由独立机制管理：CLI通过update-alternatives控制，而Apache则依赖a2enmod/a2dismod启用对应libapache2-mod-phpX.X模块。仅运行sudo update-alternatives --config php只能切换终端命令，无法影响Web服务。
✅ 正确切换流程（以升级至PHP 8.1为例）
1. 确认已安装目标版本
首先验证PHP 8.1是否已安装：
ls /usr/bin/php* | grep 8.1 # 应看到类似：/usr/bin/php8.1 /usr/bin/phar8.1 /usr/bin/phar.phar8.1
若未安装，请先执行：
sudo apt update sudo apt install php8.1 php8.1-cli php8.1-common php8.1-mysql php8.1-gd php8.1-mbstring
2. 禁用旧版Apache模块，启用新版
# 禁用当前活跃的PHP模块（如8.0） sudo a2dismod php8.0 # 启用PHP 8.1 Apache模块（确保包名匹配，通常为 libapache2-mod-php8.1） sudo a2enmod php8.1 # 重启Apache使模块生效 sudo systemctl restart apache2
⚠️ 注意：a2enmod php8.1 实际启用的是 /usr/lib/apache2/modules/libphp8.1.so 模块。若提示 Module php8.1 does not exist，请确认已安装 libapache2-mod-php8.1 包：
立即学习“PHP免费学习笔记（深入）”；
sudo apt install libapache2-mod-php8.1
3. 同步CLI默认版本
# 交互式选择（推荐） sudo update-alternatives --config php sudo update-alternatives --config phar sudo update-alternatives --config phar.phar # 或直接设定（避免交互） sudo update-alternatives --set php /usr/bin/php8.1 sudo update-alternatives --set phar /usr/bin/phar8.1 sudo update-alternatives --set phar.phar /usr/bin/phar.phar8.1
4. 验证双环境一致性
# CLI版本 php -v # Web服务器中PHP版本（模拟Apache用户权限） sudo -u www-data php -v # 检查Apache模块状态 sudo a2query -m php8.1 # 应返回 "enabled" # 最终验证：访问 phpinfo.php echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/phpinfo.php > /dev/null # 浏览器打开 http://localhost/phpinfo.php → 查看 "PHP Version" 字段
? 常见故障排查
a2enmod php8.1 报错？
→ 执行 apt list --installed | grep php8.1，确认 libapache2-mod-php8.1 已安装；若缺失，sudo apt install libapache2-mod-php8.1。phpinfo() 仍显示旧版本？
→ 检查是否遗漏 sudo systemctl restart apache2；或确认 .htaccess/虚拟主机配置未强制指定PHP版本（如 SetHandler application/x-httpd-php7.4）。多版本共存时扩展不生效？
→ PHP扩展配置文件位于 /etc/php/8.1/apache2/conf.d/ 和 /etc/php/8.1/cli/conf.d/，需分别检查 extension=xxx.so 是否启用。
? 清理与最佳实践
- 升级稳定后，可卸载旧版（如PHP 8.0）释放空间：
sudo apt remove php8.0* libapache2-mod-php8.0 sudo apt autoremove
- 建议始终通过PPA（ppa:ondrej/php）安装PHP，保障版本及时性与兼容性；
- 生产环境切换前，务必使用php -l your-script.php语法检查及小流量灰度验证。
完成上述步骤后，CLI与Apache将严格同步使用同一PHP版本，php -v与phpinfo()输出将完全一致——这是保障开发、测试、生产环境一致性的基础前提。
