Ubuntu下统一切换PHP CLI与Apache版本的完整指南-php教程-PHP中文网

Ubuntu下统一切换PHP CLI与Apache版本的完整指南

本文详解如何同步更新命令行（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

若未安装，请先执行：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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 包：
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()输出将完全一致——这是保障开发、测试、生产环境一致性的基础前提。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！