从 PHP 7.4 升级到 PHP 8.2：我遇到的坑和解决方案

最近把博客从 PHP 7.4 升级到了 PHP 8.2，过程比想象中曲折一些。虽然 PHP 8.x 性能提升明显，但兼容性问题也不少。这篇文章记录了我遇到的几个典型问题以及解决方法，希望能给正在考虑升级的朋友一些参考。

一、为什么要升级？

PHP 7.4 已于 2022 年 11 月停止安全支持，继续使用存在安全风险。而 PHP 8.x 带来了显著的性能提升：

简单来说，升级 PHP 版本是最划算的性能优化，不需要改代码就能获得 20% 以上的速度提升。

二、遇到的坑及解决方案

坑一：动态属性废弃警告

升级后，Query Monitor 立刻报了一个错误：

Creation of dynamic property WP_Object_Cache::Cache_misses is deprecated

原因： PHP 8.2 开始，禁止为未声明属性的对象动态赋值。WP_Object_Cache 是 WordPress 核心类，某些插件直接给它添加了未定义的属性。

解决方案：

• 更新所有插件到最新版本
• 更新 WordPress 到最新版本
• 如果问题仍然存在，可以临时屏蔽废弃警告（不推荐长期使用）：

// 在 wp-config.php 中添加
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);

坑二：函数签名不兼容

某些插件使用了旧版 PHP 的函数签名：

// 旧代码
function do_something($param = null) {
    // ...
}

// PHP 8.0+ 要求更严格的类型声明

解决方案： 更新插件至兼容 PHP 8.x 的版本。如果插件已停止维护，考虑寻找替代品。

坑三：preg_* 函数行为变化

PHP 8.x 对正则表达式引擎做了改进，某些在 7.4 下正常的正则表达式会触发警告：

// 触发警告
preg_match('/\w+/', $string);

// 修复方式：明确指定 u 修饰符（UTF-8）
preg_match('/\w+/u', $string);

这种情况在 WordPress 主题中比较常见，建议检查 error_log。

坑四：SimpleXML 行为变化

PHP 8.0 改变了 SimpleXML 的处理方式：

// 在 PHP 7.4 返回 null，8.0+ 抛出异常
$xml->nonexistent->child;

// 解决方案：先检查是否存在
if (isset($xml->nonexistent)) {
    $value = $xml->nonexistent->child;
}

三、升级前的准备工作

为了减少升级过程中的麻烦，建议先做好这 5 件事：

1. 备份完整站点：文件和数据库都备份，以便随时回滚
2. 检查插件兼容性：查看插件页面，确保标注支持 PHP 8.x
3. 开启调试模式：在 wp-config.php 中开启 WP_DEBUG
4. 使用测试环境：最好在本地或测试站先跑一遍
5. 准备好回滚方案：有备无患，万一出问题能快速恢复

四、推荐的升级路线

不要直接跳到最新版，分步升级更稳妥：

每次升级后观察 1-2 天，确认没有报错再继续下一步。

五、升级后的收益

完成升级后，我用 Query Monitor 做了前后对比：

注意，页面生成时间的改善不仅仅是 PHP 版本升级带来的，还包括 OPcache 调优和插件更新，但 PHP 8.2 确实贡献了很大一部分。

六、总结

PHP 升级是一项收益明显的优化，但确实需要细心准备。分享几点经验：

• ⚠️ 不要在生产环境直接升级，先用测试环境验证
• 🔍 善用 Query Monitor，它能帮你快速定位问题
• 📦 保持插件更新，这是避免兼容性问题的最佳方式
• 📋 分步升级，每步验证，方便定位是哪一步出的问题
• 📝 记录踩坑经验，方便以后参考，也能帮到其他人

如果你的网站还在 PHP 7.4 上运行，建议尽快安排升级计划——安全第一，顺便还能白捡性能提升，何乐而不为？