参考来源与致谢
- 引用来源:如何为Ubuntu中安装不同的PHP版本(5.6、7.x和8.0)-51CTO.COM
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内不同业务系统对 PHP 版本要求不一致,例如旧系统依赖 PHP 5.6,新系统使用 PHP 7.x 或 8.0。需要在同一台 Ubuntu 服务器上并存多个 PHP 版本,并按站点或命令行切换默认版本。本文给出通用操作流程,具体版本可用性与软件包名称请以对应 Ubuntu 发行版及所用软件源的官方文档为准。
准备与风险 #
- 确认服务器可访问外网或内部镜像源,并具备
sudo权限。 - 第三方软件源由社区维护,其包内容、支持周期与安全更新策略需自行评估;生产环境引入前应在测试环境验证。
- PHP 5.6 等旧版本已停止官方安全支持,继续使用存在安全风险,建议仅用于无法升级的遗留系统,并做好网络隔离。
- 操作前备份 Web 配置、站点代码与数据库;建议先在测试环境完整演练。
- 记录当前 PHP 版本、已启用模块与 Web 服务器配置,便于回退。
处理步骤 #
1. 添加软件源 #
安装添加软件源所需工具,并加入提供多版本 PHP 的第三方源。命令中的源地址请替换为组织允许使用的地址。
sudo apt install software-properties-common
sudo add-apt-repository [软件源地址]
sudo apt update
2. 安装指定版本 #
按需安装目标版本。Apache 使用模块包,Nginx 使用 FPM 包。
# Apache
sudo apt install php[版本号]
# Nginx
sudo apt install php[版本号]-fpm
3. 安装常用扩展 #
扩展包名通常为 php[版本号]-[扩展名],可按业务需要安装。
sudo apt install php[版本号]-cli php[版本号]-xml php[版本号]-mysql
4. 切换命令行默认版本 #
使用 alternatives 机制指定 php 命令指向的版本。
sudo update-alternatives --set php /usr/bin/php[版本号]
5. 绑定 Web 服务器版本 #
Apache 通过模块启停切换;Nginx 通过 FPM 服务与站点配置中的 socket 或端口指向对应版本。
# Apache:先禁用旧版本,再启用目标版本
sudo a2dismod php[旧版本号]
sudo a2enmod php[目标版本号]
sudo systemctl restart apache2
Nginx 场景下,确认站点配置中的 fastcgi_pass 指向目标版本的 FPM socket 或监听地址,然后重载服务。
验证方法 #
- 命令行:
php -v查看当前默认版本。 - 配置文件:
php -i | grep "Loaded Configuration File"确认加载的 php.ini 路径。 - Web 侧:通过站点页面或临时探针脚本查看实际生效版本,验证后及时移除探针。
- 扩展:
php -m检查所需模块是否加载。
回退建议 #
- 命令行回退:重新执行
update-alternatives --set php /usr/bin/php[原版本号]。 - Apache 回退:禁用新版本模块,启用原版本模块,重启服务。
- Nginx 回退:将站点配置的 FPM 指向改回原版本,重载服务。
- 若软件源引入导致依赖冲突,可移除该源并恢复原软件包状态;操作前保留配置备份。
常见问题 #
- 安装后
php -v仍显示旧版本:检查 alternatives 设置与 PATH 顺序。 - Web 页面版本与命令行不一致:Web 服务器使用独立模块或 FPM 进程,需单独切换。
- 扩展缺失:确认扩展包名与 PHP 版本匹配,安装后重启对应服务。
- 旧版本无法安装:部分新发行版已移除旧版本依赖,需评估兼容性或改用容器隔离。
- 版本支持范围与安全更新状态:请查阅对应版本官方文档与发行版公告。
