Debian中PHP版本如何切换

Debian中PHP版本切换指南

一 准备与安装多个版本

• 更新索引并安装必要工具：sudo apt update && sudo apt install -y ca-certificates lsb-release apt-transport-https
• 添加 SURY PHP 仓库（Debian 官方仓库通常只保留少量版本，SURY提供多版本）：
  • 导入密钥：wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
  • 添加源：echo “deb https://packages.sury.org/php/ $(lsb_release -sc) main” | sudo tee /etc/apt/sources.list.d/php.list
  • 更新索引：sudo apt update
• 安装所需版本（示例为 PHP 8.2 与 PHP 7.4；如用 Nginx/PHP-FPM，建议同时安装对应 fpm 包）：
  • sudo apt install -y php8.2 php8.2-cli php8.2-fpm
  • sudo apt install -y php7.4 php7.4-cli php7.4-fpm
• 查看已安装二进制与版本：ls /usr/bin/php*；php -v
• 说明：SURY 仓库覆盖 PHP 5.6/7.x/8.x 等多个版本，适合在同一台机器共存与切换。

二 切换 CLI 版本

• 使用 update-alternatives 注册并切换默认 php 命令：
  • 注册候选版本（示例优先级：82 > 74，数值越大优先级越高）：
    • sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82
    • sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74
  • 交互式选择：sudo update-alternatives --config php
  • 或直接指定：sudo update-alternatives --set php /usr/bin/php8.2
• 验证：php -v（应显示所选版本）
• 提示：CLI 切换只影响命令行，Web 服务需按下一节单独切换。

三 切换 Web 服务版本

• Apache 模块方式（mod_php）
  • 禁用当前模块并启用目标版本，然后重启：
    • sudo a2dismod php7.4
    • sudo a2enmod php8.2
    • sudo systemctl restart apache2
• Nginx + PHP-FPM 方式
  • 为所需版本启用对应 FPM 池（Debian 12 常用命令为 a2enconf；旧版可能为 a2enmod fpm 并配合修改站点配置中的监听）：
    • sudo a2enconf php8.2-fpm
    • sudo a2disconf php7.4-fpm
    • sudo systemctl restart php8.2-fpm
    • sudo systemctl reload nginx
  • 注意：确保站点配置中的 fastcgi_pass 指向目标版本的 FPM 监听（如 /run/php/php8.2-fpm.sock 或对应端口），与启用的 FPM 版本保持一致。
• 验证 Web 端版本：创建 /var/www/html/info.php 内容为 ，访问并确认版本与 SAPI（FPM/Apache）。

四 常用扩展与配置管理

• 安装扩展（按版本安装，避免混用）：
  • sudo apt install -y php8.2-mysql php8.2-curl php8.2-mbstring
  • sudo apt install -y php7.4-mysql php7.4-curl php7.4-mbstring
• 配置文件路径（按 SAPI 与版本区分）：
  • Apache：/etc/php/8.2/apache2/php.ini 或 /etc/php/7.4/apache2/php.ini
  • FPM：/etc/php/8.2/fpm/php.ini 或 /etc/php/7.4/fpm/php.ini
• 修改后重启对应服务（如 apache2 或 phpX.Y-fpm）使配置生效。

五 验证与排错

• 版本与路径核验：
  • 查看 CLI：php -v；which php
  • 查看所有候选：update-alternatives --list php
  • 列出已安装版本目录：ls /etc/php
• 常见问题处理：
  • CLI 与 Web 版本不一致：分别按第二、三节切换；CLI 用 alternatives，Web 用 a2enmod/a2enconf 与 FPM/Apache 配置。
  • 扩展不可用：确认扩展与当前版本匹配（如 php8.2-mysql 而非 php7.4-mysql），必要时重装扩展并重启服务。
  • 切换后 502/空白页：多为 FPM 未启动或站点未指向正确 .sock/端口，检查 phpX.Y-fpm 状态与 Nginx fastcgi_pass 配置。