如何在Ubuntu上升级PHP核心库

在 Ubuntu 上升级 PHP 核心库

升级 PHP 版本，听起来像是系统管理员的家常便饭，但一步走错，也可能让线上应用“躺平”。别担心，这份指南将带你稳扎稳打地完成整个过程，核心原则就一条：在追求新特性的同时，务必保证服务的稳定与兼容。

一 准备与版本确认

动手之前，先摸清家底。这就像医生开药前得先问诊，至关重要。

• 确认系统环境：打开终端，执行 lsb_release -a 查看 Ubuntu 具体版本。紧接着，用 php -v 命令搞清楚当前正在运行的 PHP 版本。这两个信息是后续所有操作的基础。
• 做好安全备份：强烈建议在升级前，备份重要的项目数据、数据库以及 PHP 配置文件。有备无患，永远是运维的第一课。
• 选择可靠源：尽量使用官方或社区高度认可的软件仓库。直接跨越大版本（比如从 PHP 5.x 跳到 7.x 或 8.x）替换核心包，极易引发兼容性地震，务必通过规范的仓库按步骤升级。

二 升级方案总览

根据不同的需求和场景，主要有三条路径可选。

• 使用 Ondřej Surý 的 PHP PPA（推荐方案）

  这是为 Ubuntu 及其衍生系统维护的知名第三方仓库，版本新且齐全，是大多数情况下的首选。

  • 添加仓库并更新：以安装 PHP 8.1 为例，依次执行：sudo add-apt-repository ppa:ondrej/php 和 sudo apt update。
  • 安装核心与扩展：安装 PHP 8.1 及其常用扩展：sudo apt install php8.1 php8.1-cli php8.1-common php8.1-{curl,json,gd,mbstring,intl,bcmath,zip,xml,readline}。花括号是便捷写法，会自动展开安装多个扩展。
  • Web 服务器集成：
    • 如果你使用 Nginx 或使用 event MPM 的 Apache，需要安装 FPM：sudo apt install php8.1-fpm。
    • 如果使用 prefork MPM 的 Apache，则安装模块：sudo apt install libapache2-mod-php8.1 && sudo a2enmod php8.1。
  • 验证安装：命令行输入 php -v 确认版本。对于 Web 服务，可以在网站根目录（如 /var/www/html/）创建一个 info.php 文件，内容为 ，然后通过浏览器访问该文件查看详细信息。

• 使用系统仓库“就地升级”

  如果你并不需要更换 PHP 的主版本（例如保持在 8.1 系列内），只想获取最新的安全补丁和错误修复，这是最直接的方法。

  • 直接执行：sudo apt update && sudo apt upgrade php。
  • 需要注意的是，Ubuntu 官方仓库的 PHP 版本往往比较保守。如果你希望获得某个系列下更靠后的子版本，还是需要先添加上述的 Ondřej Surý PPA 仓库，再进行升级操作。

• 多版本共存与切换（平滑迁移之道）

  对于需要逐步测试迁移的生产环境，让新旧版本共存是明智的选择。

  • 安装多个版本：例如，可以同时安装 PHP 7.4 和 8.1：sudo apt install php7.4 php8.1。
  • 切换 Apache 模块：使用 sudo a2dismod php8.1 && sudo a2enmod php7.4 && sudo systemctl restart apache2 即可快速回滚或切换。
  • 切换 CLI 默认版本：运行 sudo update-alternatives --config php，根据提示选择你想要作为全局命令行默认的 PHP 版本。如果系统中有通过 Composer 安装的 PHAR 可执行文件，也可能需要为它们单独配置 alternatives。

三 Web 服务器与 FPM 配置要点

PHP 装好了，还得让 Web 服务器认识它。这里根据服务器类型有所区别。

• Nginx + PHP-FPM
  • 确保已安装对应版本的 FPM 包，如 php8.1-fpm。
  • 在 Nginx 的站点配置文件中，找到处理 PHP 请求的 location 块，将 fastcgi_pass 指令指向正确的 FPM 套接字：fastcgi_pass unix:/run/php/php8.1-fpm.sock;（注意，套接字路径可能因版本和系统而异）。
  • 最后，重载配置：sudo systemctl reload nginx && sudo systemctl restart php8.1-fpm。
• Apache
  • 如果使用传统的 prefork MPM，直接安装并启用 libapache2-mod-phpX.Y 模块即可。
  • 如果使用 event 或 worker MPM，则需要使用 phpX.Y-fpm，并通过 proxy_fcgi 模块将请求转发给 FPM 进程。
  • 无论哪种方式，切换模块后，别忘了重启 Apache 使配置生效：sudo systemctl restart apache2。

四 扩展与兼容性处理

版本升级了，项目依赖的扩展可不能丢。

• 扩展安装与对齐
  • 扩展的安装命名规则是 phpX.Y-{ext}，例如 php8.1-curl、php8.1-intl。
  • 从旧版本升级时，一个好习惯是先列出所有已安装的 PHP 扩展：dpkg -l | grep php | tee packages.txt。然后对照这个列表，在新版本中逐一安装，避免遗漏。
  • 特别注意兼容性：一些旧扩展可能已被移除。例如，自 PHP 7.2 起，mcrypt 扩展已被废弃，如果旧项目依赖它，需要提前将加密逻辑迁移到 openssl 等替代方案中。

五 验证与回退建议

升级完成，不代表工作结束。验证和善后同样关键。

• 全面验证
  • 命令行验证：php -v 看版本，php -m 看已加载的扩展列表。
  • Web 环境验证：通过之前创建的 info.php 页面或运行一个简单的业务脚本，确认 SAPI（服务器 API）类型、扩展加载情况和配置文件路径是否正确。
• 回退与清理
  • 如何回退：如果新版本出现问题，可以利用 update-alternatives 快速切换回旧的 CLI 版本，或者在 Apache 中禁用新模块、启用旧模块，然后重启服务。
  • 清理旧版本：只有在确认所有业务都稳定运行在新版本上后，才可以考虑卸载旧版本以释放空间，例如：sudo apt purge php7.4 php7.4-*。执行前请三思。
• 长期维护
  • 定期运行 sudo apt update && sudo apt upgrade，可以获取 PHP 及其扩展组件的最新安全更新和错误修复。
  • 最后再次强调，对于生产环境，务必先在测试环境完整验证应用的兼容性与性能，再制定计划切换生产流量。稳，才是运维的终极哲学。