PHP如何在Linux上进行版本升级

Linux上升级 PHP 的实用步骤

一 升级前准备

• 备份关键资产：打包网站目录（如：tar -czf website_backup.tar.gz /var/www/html）、导出数据库（如：mysqldump -u root -p db > db_backup.sql）、备份 php.ini、www.conf 等关键配置，便于回滚。
• 确认现状：查看当前版本（php -v）、已启用扩展（php -m）、Web 与 PHP 的集成方式（mod_php 或 PHP-FPM）。
• 选择目标版本：优先选择当前系统的最新稳定版，并确认框架/CMS/Composer 依赖支持目标版本。
• 搭建测试环境：在与生产一致的测试环境先行验证，避免直接在生产变更。

二 发行版包管理升级（推荐）

• Ubuntu/Debian（使用 Ondřej Surý PPA）

  1. 添加源并安装指定版本
     sudo add-apt-repository ppa:ondrej/php
     sudo apt update
     sudo apt install php8.1（示例版本，可按需改为 8.2/8.3）
  2. 安装常用扩展
     sudo apt install php8.1-mysql php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip
  3. 多版本共存时切换 CLI
     sudo update-alternatives --config php
  4. Apache 集成
     sudo a2enmod php8.1 && sudo a2dismod php旧版本 && sudo systemctl restart apache2
  5. Nginx + PHP-FPM
     sudo systemctl start php8.1-fpm && sudo systemctl enable php8.1-fpm
     修改 Nginx 的 fastcgi_pass 指向新版本 FPM（如：/run/php/php8.1-fpm.sock），然后 sudo systemctl restart nginx
  6. 验证
     php -v 与 php -m 检查版本与扩展

• CentOS/RHEL 7/8（使用 Remi 源）

  1. 启用目标版本的 Remi 仓库（以 php 8.1 为例）
     sudo yum-config-manager --enable remi-php81
  2. 升级或安装
     sudo yum update -y php*
     或按需安装
     sudo yum install -y php php-cli php-common php-mysqlnd php-gd php-mbstring php-xml php-json
  3. 多版本切换（若共存）
     sudo yum-config-manager --disable remi-php旧版本
     sudo yum-config-manager --enable remi-php81
  4. 重启服务
     sudo systemctl restart php-fpm 或 sudo systemctl restart httpd
  5. 验证
     php -v

三 源码编译升级（备选）

• 适用于需要自定义编译参数或官方仓库无所需版本的场景。
  1. 下载并解压
     wget https://www.php.net/distributions/php-8.2.3.tar.gz
     tar -xvf php-8.2.3.tar.gz && cd php-8.2.3
  2. 配置编译参数（按需增减）
     ./configure --prefix=/usr/local/php-8.2.3 \ –with-config-file-path=/usr/local/php-8.2.3/etc \ –enable-mbstring --enable-opcache --enable-intl \ –with-curl --with-zlib --with-gd --with-jpeg \ –with-openssl --with-pdo-mysql --with-mysqli \ –enable-fpm --with-fpm-user=www --with-fpm-group=www
  3. 编译与安装
     make -j$(nproc) && sudo make install
  4. 软链与配置
     sudo ln -sfn /usr/local/php-8.2.3/bin/php /usr/bin/php
     sudo ln -sfn /usr/local/php-8.2.3/sbin/php-fpm /usr/sbin/php-fpm
     sudo cp php.ini-production /usr/local/php-8.2.3/etc/php.ini
     sudo cp /usr/local/php-8.2.3/etc/php-fpm.conf.default /usr/local/php-8.2.3/etc/php-fpm.conf
     sudo cp /usr/local/php-8.2.3/etc/php-fpm.d/www.conf.default /usr/local/php-8.2.3/etc/php-fpm.d/www.conf
  5. 启动 FPM（示例为 systemd）
     sudo cp sapi/fpm/php-fpm.service /etc/systemd/system/php-fpm.service
     sudo systemctl daemon-reload && sudo systemctl start php-fpm && sudo systemctl enable php-fpm
  6. 验证
     php -v；如 9000 端口被占用，先排查并结束旧进程再启动

四 切换与验证

• CLI 与 FPM 版本一致性：CLI 用 update-alternatives --config php 选择；FPM 通过 systemd 单元（如 php8.1-fpm）或监听 sock 文件区分版本。
• Web 服务器联动：
  • Apache：启用新模块并禁用旧模块（如 a2enmod/a2dismod），重启 apache2。
  • Nginx：将 fastcgi_pass 指向新版本 .sock（如 /run/php/php8.1-fpm.sock），重启 nginx。
• 功能与扩展验证：
  • 创建 info.php（）核对版本与扩展；
  • 使用 php -m 检查扩展是否加载；
  • 访问核心业务与 API，观察错误日志与性能表现。

五 兼容性与回滚要点

• 兼容性处理：
  • 参考官方 Migration Guide，重点处理被移除/弃用特性（如 mysql_* 系列在 PHP 7.0+ 移除，改用 mysqli/PDO）；
  • 修正语法/类型变更（如 PHP 7.3+ heredoc 缩进要求、PHP 8 的异常与严格类型）；
  • 升级 Composer 依赖并校验 composer.json 的 PHP 版本约束，必要时先升级框架/库。
• 测试与灰度：在测试环境完整回归（表单、登录、支付、API、队列等），开启 E_ALL 日志，必要时灰度发布。
• 回滚方案：保留旧版本包/二进制与配置；需要时快速切换 CLI（update-alternatives）、切换 FPM 单元或恢复软链，再重启 Web 服务。