如何在Ubuntu上升级PHP核心库

在 Ubuntu 上升级 PHP 核心库

一 准备与版本确认

• 先确认系统版本与当前 PHP 版本：
  • lsb_release -a
  • php -v
• 建议先备份数据与配置，并尽量使用官方或可信仓库，避免跨大版本直接替换导致兼容性问题。

二 升级方案总览

• 使用 Ondřej Surý 的 PHP PPA（推荐，适用于 Ubuntu 主流版本）

  • 添加仓库并安装所需版本（示例为 8.1）：sudo add-apt-repository ppa:ondrej/php && sudo apt update
  • 安装核心与常用扩展：sudo apt install php8.1 php8.1-cli php8.1-common php8.1-{curl,json,gd,mbstring,intl,bcmath,zip,xml,readline}
  • Web 集成：
    • Nginx 或 Apache 使用 event MPM：sudo apt install php8.1-fpm
    • Apache 使用 prefork MPM：sudo apt install libapache2-mod-php8.1 && sudo a2enmod php8.1
  • 验证：php -v；如为 Web，创建 /var/www/html/info.php 输出 phpinfo() 访问验证。

• 使用系统仓库或第三方仓库的“就地升级”（不更换主版本）

  • 适用于只想获取当前系列的最新补丁与安全修复：sudo apt update && sudo apt upgrade php
  • 若系统仓库版本较旧，可先添加 Ondřej Surý 仓库再执行升级，以获取更新版本线。

• 多版本共存与切换（便于逐步迁移）

  • 同时安装多个版本（示例：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（按提示选择版本）；必要时为 phar 等可执行文件也设置 alternatives。

三 Web 服务器与 FPM 配置要点

• Nginx + PHP-FPM
  • 安装对应版本的 FPM：sudo apt install php8.1-fpm
  • 在 Nginx server 配置中设置：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 转发请求
  • 切换模块后务必重启 Apache：sudo systemctl restart apache2

四 扩展与兼容性处理

• 扩展安装与对齐
  • 按需安装扩展，命名规则为 phpX.Y-{ext}（如：php8.1-curl、php8.1-intl、php8.1-mbstring）
  • 从旧版本升级时，建议先列出已装扩展并对照安装，避免遗漏：dpkg -l | grep php | tee packages.txt
  • 注意：PHP 7.2 起已移除 mcrypt，如旧项目依赖需迁移到 openssl 等替代方案。

五 验证与回退建议

• 验证
  • CLI：php -v 与 php -m（查看已加载扩展）
  • Web：访问 info.php 或简单脚本确认 SAPI、扩展与配置路径
• 回退与清理
  • 回退版本：使用 update-alternatives 选择旧版本，或在 Apache 中切换模块，再重启服务
  • 移除旧版本（确认业务无依赖后再执行）：sudo apt purge php7.4 php7.4-*
• 维护
  • 定期执行：sudo apt update && sudo apt upgrade（获取 PHP 与安全组件的最新修复）
  • 生产环境建议先在测试环境验证，再切换生产流量。