PHP 版本升级后网站出现兼容错误如何回滚？

学完这篇，你能在十几分钟内把网站从出错的 PHP 新版本安全切回旧版本，并搞清楚每一步该改哪个配置文件、该看哪个日志。

第一步：先确认报错真的是 PHP 版本引起的

这一步的目标是排除干扰项，避免改了半天发现是数据库或代码的锅。先打开站点错误日志（宝塔在 /www/wwwlogs/你的域名.error.log，LNMP 在 /var/log/nginx/error.log），搜这几类关键字：

• Parse error: syntax error, unexpected —— 代码里有新版本才支持的语法
• Call to undefined function mysql_connect() —— PHP 7 已删除 mysql_* 系列函数
• Unable to load dynamic library —— 扩展和新版本不匹配
• 大量 Deprecated: 警告刷屏但页面能开

再用 php -v 看命令行版本，用 <?php phpinfo(); ?> 临时文件看网站实际跑的版本（两者经常不一致）。如果页面直接 502 Bad Gateway，先 systemctl status php8.2-fpm 看进程是不是压根没起来。

第二步：备份当前文件和数据库

改之前先留后路，出问题能立刻退回来。

tar -czf /root/web_$(date +%F).tar.gz /www/wwwroot/example.com
mysqldump -u root -p example_db > /root/example_db_$(date +%F).sql
cp -a /etc/php /root/php_config_bak

宝塔面板用户也可以直接在「网站 → 站点 → 备份」里点一次备份，数据库同理。

第三步：把 PHP 版本切回去

这一步是整个回滚的核心，做完网站就恢复到旧版本运行环境了。按你的环境选一种：

宝塔 / aaPanel：进入「网站 → 你的站点 → 设置 → PHP版本」，下拉框选原来的 7.4，点保存。然后去「软件商店 → PHP 7.4 → 设置 → 服务」，确认 php-fpm 处于运行状态。

Ubuntu / Debian（apt 装的多版本）：

apt install php7.4-fpm php7.4-mysql php7.4-curl php7.4-mbstring
update-alternatives --set php /usr/bin/php7.4

Nginx 站点配置里把 fastcgi_pass unix:/run/php/php8.2-fpm.sock; 改成 unix:/run/php/php7.4-fpm.sock;。Apache 则执行 a2dismod php8.2 && a2enmod php7.4。

CentOS / RHEL（Remi 源）：

dnf module reset php
dnf module enable php:remi-7.4
dnf install php-fpm php-mysqlnd

Docker 部署：把 docker-compose.yml 里的 image: php:8.2-fpm 改回 image: php:7.4-fpm，再 docker compose up -d。注意 volumes 挂载的 php.ini 和 Dockerfile 里的扩展安装命令也要对应版本。

注意：切版本时扩展必须跟着换。PHP 8.2 编译的 opcache.so、redis.so 不能给 7.4 加载，否则 fpm 直接起不来，日志里报 Unable to load dynamic library。宝塔用户可以在「PHP 7.4 → 设置 → 安装扩展」里重装一遍。

第四步：重启服务并验证结果

重启让新配置生效，然后逐项确认。

systemctl restart php7.4-fpm
nginx -t && systemctl reload nginx
php -v
curl -I https://你的域名

php -v 应显示旧版本号，访问临时 phpinfo 页面确认网站用的也是旧版本，curl -I 返回 200，再 tail -f /var/log/nginx/error.log 观察几分钟没有新报错。验证完把 phpinfo.php 删掉。

第五步：处理"代码已经被改成只兼容新版 PHP"的情况

如果升级期间你还跑过 composer update，只切 PHP 版本是不够的，依赖包已经要求 PHP 8 了。回滚依赖：

git checkout HEAD~1 -- composer.json composer.lock
composer install --no-dev

想定位具体哪里不兼容，可以用 PHPCompatibility 扫描：

composer require --dev phpcompatibility/php-compatibility
./vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 7.4-8.2 ./app

注意：update-alternatives 只改命令行的 php，不影响已经在跑的 php-fpm，也不改 Nginx 里的 fastcgi_pass。两处都要动，否则会出现"命令行显示 7.4、网站还跑 8.2"的迷惑现象。

小结

• 回滚前先看错误日志确认是版本问题，并备份文件和数据库
• 切版本要动三处：fpm 进程、Web 服务器指向的 sock/模块、对应版本的扩展
• Nginx 改 fastcgi_pass，Apache 用 a2dismod/a2enmod，宝塔在站点设置的 PHP版本 下拉框里改
• 改完必须重启 php-fpm 并 reload Nginx，用 phpinfo 和 curl 双重验证
• 跑过 composer update 的项目还要回滚 composer.lock，否则依赖层还是不兼容
• 想只回滚单站点，用独立 PHP-FPM 池或每个 vhost 单独指定 sock 即可