---
title: Ubuntu 多版本 PHP 共存与切换运维指南
description: 面向企业 IT 运维，说明在 Ubuntu 上通过第三方软件源并存安装 PHP 5.6、7.x、8.0 的通用流程，涵盖适用场景、准备与风险、安装步骤、默认版本切换、Apache 与 Nginx 的模块绑定、验证方法、回退建议及常见问题，所有环境参数以占位符表示。
url: "https://www.lanever.com/docs/ubuntu-%e5%a4%9a%e7%89%88%e6%9c%ac-php-%e5%85%b1%e5%ad%98%e4%b8%8e%e5%88%87%e6%8d%a2%e8%bf%90%e7%bb%b4%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Linux
---

# Ubuntu 多版本 PHP 共存与切换运维指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[如何为Ubuntu中安装不同的PHP版本（5.6、7.x和8.0）-51CTO.COM](https://os.51cto.com/article/641074.html)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

企业内不同业务系统对 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 版本匹配，安装后重启对应服务。
- 旧版本无法安装：部分新发行版已移除旧版本依赖，需评估兼容性或改用容器隔离。
- 版本支持范围与安全更新状态：请查阅对应版本官方文档与发行版公告。
