Debian PHP服务如何降级

Debian 上 PHP 降级的推荐做法

一 准备与版本确认

• 明确目标版本与部署方式：是 Apache 模块（libapache2-mod-php）、PHP-FPM + Nginx/Apache，还是仅 CLI。
• 列出已装包并备份：
  • 查看：dpkg -l | grep php | tee php-packages-before.txt
  • 备份配置：tar czf php-conf-$(date +%F).tgz /etc/php /etc/apache2/mods-available /etc/php/*/fpm /etc/nginx/sites-available
• 确认当前版本与 SAPI：
  • php -v、php -m
  • Apache：apache2ctl -M | grep php；FPM：systemctl status php*-fpm

二 降级方案总览

说明：在 Debian 10 Buster 等系统上，常见做法是先添加 Ondřej Surý 的 PHP 仓库，安装多个 PHP 版本，然后通过 alternatives 与 a2enmod/a2dismod 在版本间切换；CLI 用 alternatives，Apache 模块用 a2enmod/a2dismod，FPM 则切换站点配置中的 socket 并重启服务。

三 分步操作示例

• 示例一 Apache 模块方式（从 8.2 降到 7.4）

  1. 安装目标版本模块（若未安装）：sudo apt install libapache2-mod-php7.4
  2. 禁用高版本并启用低版本：sudo a2dismod php8.2 && sudo a2enmod php7.4
  3. 重启 Apache：sudo systemctl restart apache2
  4. 验证：php -v（若仍为 8.2，见下一节“CLI 与 FPM 一致性”）

• 示例二 PHP-FPM + Nginx（从 8.2 降到 7.4）

  1. 安装目标版本 FPM：sudo apt install php7.4-fpm
  2. 启用代理与 FPM 配置（Apache）：sudo a2enmod proxy_fcgi setenvif && sudo a2enconf php7.4-fpm
  3. 调整站点配置，将 FastCGI 指向低版本 socket（常见为 /run/php/php7.4-fpm.sock），保存后重载：
     • Nginx：sudo systemctl reload nginx
     • Apache：sudo systemctl reload apache2
  4. 重启 FPM：sudo systemctl restart php7.4-fpm
  5. 验证：curl -I http://localhost/info.php 或 php-fpm7.4 -v

• 示例三 CLI 与 FPM 一致性

  • 若 CLI 仍是高版本，切换 CLI 默认：
    sudo update-alternatives --config php（选择 /usr/bin/php7.4）
    或显式设置：sudo update-alternatives --set php /usr/bin/php7.4
  • 验证：php -v 与 php-fpm7.4 -v 输出应一致为目标版本

四 版本钉住与回滚（当仓库仅保留高版本时）

• 思路：为低版本包设置更高的 Pin-Priority，让 APT 优先选择旧版本。
• 步骤：
  1. 确认低版本仍可从某仓库安装（如旧版 php5.6 在 sury 仓库的历史版本）：
     sudo apt update && apt-cache policy php5.6
  2. 创建钉住文件：sudo tee /etc/apt/preferences.d/php-downgrade <<'EOF'

     Package: php5.6*
     Pin: release a=bullseye
     Pin-Priority: 991
     
     Package: php7.4*
     Pin: release a=bullseye
     Pin-Priority: 500
     EOF`
     

  3. 安装目标版本：sudo apt install php5.6 php5.6-cli php5.6-fpm（按需增减模块）
  4. 按第三节方法切换 CLI/FPM/Apache 后重启服务
  5. 验证：php -v、php-fpm5.6 -v、apache2ctl -M | grep php
• 风险提示：旧版本可能缺少安全更新，生产环境应谨慎评估并尽量使用受支持的版本；钉住仅改变安装优先级，不会自动卸载高版本，必要时再 apt purge php8.2*。

五 验证与回滚

• 快速验证
  • CLI：php -v、php -m
  • Web：创建 /var/www/html/info.php 内容为 <?php phpinfo(); ?>，访问确认版本与模块
  • FPM：systemctl status php*.fpm、ss -lntp | grep php
  • Apache：apache2ctl -M | grep php
• 一键回滚思路
  • 切回高版本模块/FPM：sudo a2dismod php7.4 && sudo a2enmod php8.2 && sudo systemctl restart apache2 php8.2-fpm
  • 或 CLI：sudo update-alternatives --set php /usr/bin/php8.2
  • 若曾钉住低版本，可删除 /etc/apt/preferences.d/php-downgrade 并 sudo apt update

以上步骤覆盖了 CLI、Apache 模块、PHP-FPM 三种常见部署的降级路径，并提供了在仓库无旧版本时的 版本钉住 方案。操作前务必完成配置与数据的备份，并在灰度环境验证后再切换到生产。