Debian PHP版本更新有哪些注意事项

Debian 更新 PHP 的关键注意事项

一 版本选择与仓库优先级

• 明确目标版本：优先选择仍在Debian 安全支持周期内的版本；若需新特性，再考虑第三方仓库。
• 仓库取舍：Debian 官方仓库通常较保守；如需较新版本，常用做法是添加 Ondřej Surý 的 PHP 仓库（适用于 Debian/Ubuntu）。添加前确认系统代号（如 bookworm/bullseye）与仓库匹配。
• 多版本共存：Debian 的 PHP 包支持并行安装（如 php7.4/php8.3 并存），便于逐步迁移与灰度验证。
• 重要纠正：不要使用 Ubuntu 的 ppa:ondrej/php 在 Debian 上添加源，应使用 Debian 专用的 deb.sury.org 仓库与签名密钥。

二 升级前的兼容性评估与准备

• 全面备份：备份网站文件、数据库、配置文件（如 /etc/php/ 各版本目录）、以及包清单（如 dpkg -l | grep php > packages.txt）。
• 依赖与扩展盘点：列出当前扩展与版本，便于升级后逐一核对与补齐（如 php-mysql、php-curl、php-gd、php-mbstring、php-xml、php-zip 等）。
• 代码兼容性扫描：使用 PHPCompatibility 等工具对代码进行静态扫描，提前发现被移除/变更的函数、参数与行为差异。
• 框架与组件核对：确认所用 框架/CMS/第三方库 明确支持目标 PHP 版本；必要时先在测试环境验证。
• 升级策略：建议按小版本递增逐步升级，便于定位问题；必要时保留旧版本以便快速回滚。

三 升级过程中的关键操作

• 正确的仓库与密钥导入（Debian 专用）：
  • 安装必要工具：sudo apt install apt-transport-https curl
  • 导入签名密钥：sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
  • 添加源：echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
  • 更新索引：sudo apt update
• 安装目标版本与扩展（示例为 8.3）：
  • sudo apt install php8.3 php8.3-cli php8.3-{bz2,curl,mbstring,intl}
  • Web 场景按需安装：
    • FPM：sudo apt install php8.3-fpm
    • Apache 模块：sudo apt install libapache2-mod-php8.3
• SAPI 与 Web 服务器联动：
  • Apache：启用对应模块（如 libapache2-mod-php8.3），必要时调整站点配置后再重启：sudo systemctl restart apache2
  • Nginx + PHP-FPM：确保 FPM 池监听与 Nginx fastcgi_pass 指向一致（如 127.0.0.1:9000 或 /run/php/php8.3-fpm.sock），然后重启：sudo systemctl restart nginx && sudo systemctl restart php8.3-fpm
• 多版本切换与 CLI 一致性：
  • 使用 update-alternatives 管理默认 php 命令：sudo update-alternatives --set php /usr/bin/php8.3
  • 验证：php -v、update-alternatives --list php、ls /etc/php

四 升级后的验证与回滚

• 版本与扩展核对：
  • CLI：php -v、php -m
  • FPM：检查进程与监听：systemctl status php8.3-fpm、ss -lntp | grep php 或 ls /run/php/
  • Web：创建 phpinfo.php 或通过 php -S 临时服务核对 Loaded Configuration File、扩展与 API 版本。
• 功能与性能回归：在预发布环境进行全链路测试（登录、支付、上传、队列、缓存、外部 API 等），关注 错误日志 与 慢查询。
• 回滚方案：
  • 切换 CLI 版本：sudo update-alternatives --set php /usr/bin/php8.2
  • Web 切换到旧版 FPM 或 Apache 模块并重启服务；必要时 apt install 旧版包并禁用新版。
  • 若使用第三方仓库导致依赖混乱，可移除该源并 apt purge 新版后重装旧版。

五 安全与运维实践

• 持续安全更新：定期执行 sudo apt update && sudo apt upgrade，及时获取 安全补丁；生产环境变更遵循灰度/维护窗口。
• 配置与性能：核对 php.ini（如 error_reporting、display_errors、memory_limit、upload_max_filesize）、启用并调优 OPcache；FPM 调整 pm.max_children、pm.start_servers 等以匹配负载。
• 最小权限与隔离：FPM 以专用系统用户运行，限制目录访问；与 Web 服务器进程权限分离。
• 变更留痕：记录升级前后版本、扩展、配置与回滚预案；保留 packages.txt 与关键配置备份，便于审计与恢复。