升级 PHP 版本出问题,绝大多数不是升级那一刻坏的,是升级前没盘清楚:哪些插件用了被移除的函数、哪些页面根本没测、出事之后靠什么切回去。下面这套顺序不要颠倒——先盘点,再静态扫描,再在隔离环境跑一遍,最后才动生产。
这些输出要存档,出问题时它是唯一的对照物。
php -v
php --ini
php -m | sort > /tmp/php-ext-before.txtWordPress 这一侧用 WP-CLI 拉清单:
cd /var/www/html
wp core version
wp plugin list --fields=name,status,version --format=table
wp theme list --fields=name,status,version --format=table容易被漏掉的三处,单独看一眼:
ls -la wp-content/mu-plugins 2>/dev/null
ls -la wp-content/object-cache.php wp-content/advanced-cache.php wp-content/db.php 2>/dev/nullmu-plugins 是强制加载的插件,后台插件列表里看不到;object-cache.php 这类 drop-in 是直接塞进 wp-content 的文件,跟着主题插件一起升级时经常被忘掉。
php -l 查不出来的东西php -l 只做语法检查。被移除的函数、被改掉的参数签名、废弃的隐式转换,它一律不报。这些要到运行时才炸。
先用 grep 做一次粗筛(会有误报,命中的要人工看):
grep -rnE --include='*.php' \
'\b(each|create_function|money_format|ereg|eregi|split|mysql_[a-z_]+|utf8_encode|utf8_decode)\s*\(' \
wp-content/themes wp-content/plugins wp-content/mu-plugins 2>/dev/null | head -100正式扫描用 PHPCompatibility(PHP_CodeSniffer 的规则集):
composer global require --dev "phpcompatibility/php-compatibility:^9.3"
export PATH="$HOME/.composer/vendor/bin:$PATH"
phpcs --config-set installed_paths "$HOME/.composer/vendor/phpcompatibility/php-compatibility"
phpcs -i # 输出里应能看到 PHPCompatibility如果 composer global 的目录在 ~/.config/composer,把上面的路径换掉即可。然后按目标版本范围扫描:
phpcs -p --standard=PHPCompatibility \
--runtime-set testVersion 8.1-8.3 \
--extensions=php \
--report=summary \
wp-content/themes/your-theme wp-content/plugins/your-plugin扫描优先级:自己写的主题和自研插件排第一,第三方插件排第二。第三方插件的扫描结果只能作为决策参考——你能改的是「换不换它」,不是「改它的代码」。对第三方插件,实际能做的判断是三件事:插件是否仍在维护、是否声明支持目标 PHP 版本、有没有可以替代的方案。这三条都没有把握时,把它列进「升级后重点观察名单」。
先把环境隔离出来:复制一份数据库和文件到 staging,改掉站点地址,关掉搜索引擎索引,把外发邮件和支付回调都掐掉,避免测试动作打到真实用户和真实订单上。
打开日志,让废弃提示落到文件里,而不是显示在页面上:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );跑的时候盯住日志:
tail -f wp-content/debug.log | grep -iE 'deprecated|warning|fatal'注意:Deprecated 大多当下不致命,但它标示的是下一个大版本会移除的东西,要单独记一份待办,不要因为「页面没白」就当成通过。
测试范围按「功能入口」列,不按「页面」列——页面会漏,入口不会:
入口 | 要验证的点 |
|---|---|
前台各类页面 | 首页、列表页、详情页、搜索页、404 各打开一次,看日志有没有新增告警 |
登录与权限 | 管理员登录、普通用户登录、找回密码、退出 |
表单提交 | 联系表单、询盘表单各提交一次,确认入库和邮件都到达 |
支付/回调 | 用测试商户号走一遍下单到回调,确认签名校验通过 |
文件上传 | 传一张图、传一个非图片文件,看缩略图生成和大小限制 |
定时任务 | 手动触发一次计划任务,确认没有报错 |
REST 接口 | 用 curl 打一遍站内实际在用的接口,看返回码和 JSON 结构有无变化 |
后台保存 | 编辑一篇文章、改一次设置、装/停一个插件 |
字符串处理、正则、日期函数、JSON 编解码这几类是最容易在跨版本时行为变化的,凡是涉及它们的自定义功能,权重往上提。
回滚方案不是一句「有事切回去」,是三条具体的命令和一个人。
备份(切换前 10 分钟做)
mkdir -p /backup
cd /var/www/html
wp db export /backup/db-$(date +%F-%H%M).sql
tar czf /backup/files-$(date +%F-%H%M).tar.gz wp-content
php -v > /backup/php-before.txt && php --ini >> /backup/php-before.txt && php -m | sort >> /backup/php-before.txt切换方式要提前确认是哪一种,并且知道怎么倒回去:面板里切换 PHP 版本(旧版本二进制还在,倒回去是一个下拉框)、多版本共存 + 符号链接(改链接指向)、容器(回滚到上一个镜像 tag)。三种方式里,只有第一种是「不需要准备」的。
回滚动作:
# 1) 切回旧 PHP 版本(面板/符号链接/镜像 tag)
# 2) 如果数据结构也动过,恢复数据库与文件
wp db import /backup/db-2026-10-24-0900.sql
tar xzf /backup/files-2026-10-24-0900.tar.gz -C /var/www/html
# 3) 清 opcache、重启 PHP-FPM
systemctl reload php-fpm一个必须提前想清楚的点:只升 PHP 不动数据库,回滚是纯切换;如果升级过程中顺手跑了会改表结构的操作(插件自动迁移、主题激活脚本),回滚就要连库一起回,并且会丢掉切换之后产生的新数据。所以约定一条:切换窗口内不做任何会改 schema 的动作。
回滚触发条件写成可判断的,不要写成「感觉不对就回滚」:
挑访问低峰,一次只改一个变量:先切 PHP,不动插件版本,不动主题代码。切完盯 30 分钟日志和错误率,再放开给全部流量。旧版本的 PHP 二进制至少保留 48 小时再清理——清理是最后一步,不是第一步。
php.ini 路径、扩展列表WP_DEBUG_LOG,按功能入口逐项测wp-content、当前 PHP 配置老站改造、迁移这类工作我们按定制开发接:客户填需求表、我们报价、付 50% 开工,验收付尾款。范围与流程见 aumcreate.com/services。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。