首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >升级 PHP 版本前要检查什么:预检、测试范围与回滚预案

升级 PHP 版本前要检查什么:预检、测试范围与回滚预案

原创
作者头像
用户10345225
发布于 2026-10-24 13:59:49
发布于 2026-10-24 13:59:49
1520
举报

升级 PHP 版本出问题,绝大多数不是升级那一刻坏的,是升级前没盘清楚:哪些插件用了被移除的函数、哪些页面根本没测、出事之后靠什么切回去。下面这套顺序不要颠倒——先盘点,再静态扫描,再在隔离环境跑一遍,最后才动生产。

一、先把「现在跑的是什么」记下来

这些输出要存档,出问题时它是唯一的对照物。

代码语言:bash
复制
php -v
php --ini
php -m | sort > /tmp/php-ext-before.txt

WordPress 这一侧用 WP-CLI 拉清单:

代码语言:bash
复制
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

容易被漏掉的三处,单独看一眼:

代码语言:bash
复制
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/null

mu-plugins 是强制加载的插件,后台插件列表里看不到;object-cache.php 这类 drop-in 是直接塞进 wp-content 的文件,跟着主题插件一起升级时经常被忘掉。

二、静态扫描:php -l 查不出来的东西

php -l 只做语法检查。被移除的函数、被改掉的参数签名、废弃的隐式转换,它一律不报。这些要到运行时才炸。

先用 grep 做一次粗筛(会有误报,命中的要人工看):

代码语言:bash
复制
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 的规则集):

代码语言:bash
复制
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,把上面的路径换掉即可。然后按目标版本范围扫描:

代码语言:bash
复制
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,改掉站点地址,关掉搜索引擎索引,把外发邮件和支付回调都掐掉,避免测试动作打到真实用户和真实订单上。

打开日志,让废弃提示落到文件里,而不是显示在页面上:

代码语言:php
复制
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

跑的时候盯住日志:

代码语言:bash
复制
tail -f wp-content/debug.log | grep -iE 'deprecated|warning|fatal'

注意:Deprecated 大多当下不致命,但它标示的是下一个大版本会移除的东西,要单独记一份待办,不要因为「页面没白」就当成通过。

测试范围按「功能入口」列,不按「页面」列——页面会漏,入口不会:

入口

要验证的点

前台各类页面

首页、列表页、详情页、搜索页、404 各打开一次,看日志有没有新增告警

登录与权限

管理员登录、普通用户登录、找回密码、退出

表单提交

联系表单、询盘表单各提交一次,确认入库和邮件都到达

支付/回调

用测试商户号走一遍下单到回调,确认签名校验通过

文件上传

传一张图、传一个非图片文件,看缩略图生成和大小限制

定时任务

手动触发一次计划任务,确认没有报错

REST 接口

用 curl 打一遍站内实际在用的接口,看返回码和 JSON 结构有无变化

后台保存

编辑一篇文章、改一次设置、装/停一个插件

字符串处理、正则、日期函数、JSON 编解码这几类是最容易在跨版本时行为变化的,凡是涉及它们的自定义功能,权重往上提。

四、回滚:在切换之前就要能执行

回滚方案不是一句「有事切回去」,是三条具体的命令和一个人。

备份(切换前 10 分钟做)

代码语言:bash
复制
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)。三种方式里,只有第一种是「不需要准备」的。

回滚动作:

代码语言:bash
复制
# 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 的动作。

回滚触发条件写成可判断的,不要写成「感觉不对就回滚」:

  • 出现白屏或 500,且 10 分钟内定位不到原因
  • 表单或支付回调失败率明显高于切换前
  • 日志里出现 Fatal error
  • 后台无法保存内容或无法登录

五、切换当天的节奏

挑访问低峰,一次只改一个变量:先切 PHP,不动插件版本,不动主题代码。切完盯 30 分钟日志和错误率,再放开给全部流量。旧版本的 PHP 二进制至少保留 48 小时再清理——清理是最后一步,不是第一步。

附:一页预检清单

  • 记录当前 PHP 版本、php.ini 路径、扩展列表
  • 导出插件/主题清单,单独确认 mu-plugins 和 drop-in 文件
  • grep 粗筛被移除函数,命中项逐条确认
  • 用 PHPCompatibility 按目标版本扫描自研代码
  • 第三方插件确认维护状态与兼容声明
  • staging 环境复刻生产,关闭索引与外发
  • 打开 WP_DEBUG_LOG,按功能入口逐项测
  • 备份数据库、wp-content、当前 PHP 配置
  • 确认切换方式与回滚命令,指定执行人
  • 约定回滚触发条件
  • 低峰切换,旧版本保留 48 小时

老站改造、迁移这类工作我们按定制开发接:客户填需求表、我们报价、付 50% 开工,验收付尾款。范围与流程见 aumcreate.com/services。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、先把「现在跑的是什么」记下来
  • 二、静态扫描:php -l 查不出来的东西
  • 三、测试范围:不是打开首页看一眼
  • 四、回滚:在切换之前就要能执行
  • 五、切换当天的节奏
  • 附:一页预检清单
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档