Debian PHP怎么更新

Debian 更新 PHP 的正确做法

一 标准流程

• 备份与检查：备份网站目录与数据库，检查当前 PHP 与扩展版本。
  • 备份示例：tar czf www-$(date +%F).tgz /var/www/html；mysqldump -u root -p --all-databases > all-dbs-$(date +%F).sql
  • 查看版本：php -v；dpkg -l | grep php
• 更新索引并升级：优先使用发行版仓库的常规升级，避免跨主版本跳跃。
  • sudo apt update && sudo apt full-upgrade -y
  • 如仅想升级 PHP 相关包：sudo apt install --only-upgrade php*
• 重启服务：
  • Apache：sudo systemctl restart apache2
  • Nginx + PHP-FPM：sudo systemctl restart nginx php8.x-fpm（将 8.x 替换为实际版本）
• 验证：php -v；或创建 /var/www/html/info.php 输出 phpinfo() 并在浏览器访问确认。

二 需要新版本时的官方方式（SURY 仓库）

• 适用于 Debian 11/12 需要 PHP 8.2/8.3/8.4 等新版本的场景（官方仓库通常版本较旧）。
• 添加 SURY 仓库（推荐 GPG 密钥环方式）：
  • sudo apt install -y apt-transport-https lsb-release ca-certificates wget
  • 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.4）：
  • sudo apt install php8.4 php8.4-cli php8.4-fpm php8.4-mysql php8.4-gd php8.4-mbstring php8.4-xml php8.4-curl
• 重启服务并验证：sudo systemctl restart apache2 或 sudo systemctl restart nginx php8.4-fpm；php -v。

三 多版本共存与切换

• CLI 切换（推荐）：使用 update-alternatives 管理默认 php、phpize、php-config。
  • 交互选择：sudo update-alternatives --config php
  • 指定版本：sudo update-alternatives --set php /usr/bin/php8.4
  • 同步工具链：sudo update-alternatives --set phpize /usr/bin/phpize8.4；sudo update-alternatives --set php-config /usr/bin/php-config8.4
• Apache 切换模块：
  • 禁用旧版：sudo a2dismod php8.3
  • 启用新版：sudo a2enmod php8.4
  • 重启：sudo systemctl restart apache2
• 提示：Nginx 通常通过 FPM 与不同 socket 或端口区分版本，无需 a2enmod。

四 升级后的收尾与优化

• 移除旧版本（确认业务无依赖后再清理）：
  • 示例：sudo apt purge php8.3*（替换为实际旧版本）
  • 清理：sudo apt autoremove -y && sudo apt autoclean
• 安全与性能：
  • 安全参数（编辑对应 php.ini，如 /etc/php/8.4/apache2/php.ini 或 FPM 池配置）：
    • display_errors = Off；expose_php = Off；allow_url_fopen = Off；allow_url_include = Off
  • 启用 OPcache：sudo apt install php-opcache；sudo phpenmod opcache；重启服务
  • 自动安全更新：sudo apt install unattended-upgrades；sudo dpkg-reconfigure unattended-upgrades。

五 常见问题与排错

• 扩展未随版本升级：为新版本单独安装扩展（如 php8.4-curl、php8.4-mbstring），保持与 CLI/FPM 版本一致。
• 502/504 错误：检查 FPM 是否运行且监听正确（socket 或端口），确认 Nginx/Apache 与 FPM 版本匹配并重启服务。
• 命令行与 Web 版本不一致：CLI 可能指向另一版本，使用 update-alternatives 统一默认 php，或在 Web 环境使用 phpinfo() 核对。
• 风险提示：跨主版本升级可能引入不兼容变更，务必先在测试环境验证并备份数据与配置。