PHP 7.2 → 8.2.35 升级解决方案(按优先级排序)

在 versions.html 中梳理出的变更点里,针对从 7.2 一次性升级到 8.2.35 时应当最先着手的项目,按必要性(放置不管的危险程度)和影响范围(涉及代码库的广度)进行了优先级排序。每个项目右侧附有示例代码/配置示例。时间有限时请按 P0 → P1 的顺序处理,P2、P3 即使延后处理也不太会造成致命故障。同时收录了截至 2026年10月22日发布的 8.5.12 / 8.4.27 / 8.3.36 / 8.2.35 为止的补丁版本中行为发生变化的项目(项目名中以“(8.4.27+/8.5.12+)”的形式注明适用的补丁版本)。

时间紧迫时一次性升级到 8.2.35 的推进方法
  1. 先通读 P0~P3 的 70 个项目:这 70 个附带示例代码的项目是“影响特别大/特别容易忽略”的精选,主要是 rector 等自动转换工具难以发现的设计判断(PDO 错误模式变更、@ 运算符行为变化、资源→对象的类型判断变化等)。在核对全部 308 项之前先在这里掌握思路,有助于正确判断后续工具的输出。
  2. 用 check-required-items.sh 机械地核对实际代码:将代码与根据简易对照表 308 项(其中必须 226 项)的函数名、关键字自动生成的检查清单进行比对,只筛选出实际命中的项目。每个项目都带有 P0~P3 优先级,报告中也可以从 P0 开始依次确认。
    执行示例
    ./check-required-items.sh /path/to/your-project
    # 同时核对推荐(P3)项目
    ./check-required-items.sh /path/to/your-project --include-recommended
    # 同时显示未命中的项目和没有自动模式的项目
    ./check-required-items.sh /path/to/your-project --verbose
    # 同时将报告保存为 Markdown / HTML 文件
    ./check-required-items.sh /path/to/your-project --output=report.md
    ./check-required-items.sh /path/to/your-project --output=report.html --include-recommended
    命中的项目编号(#数字)与 index.html 底部简易对照表以及 versions.html / 改修点-優先順.html 中的相同编号相对应。模式是根据函数名、常量名等自动生成的简易模式,最终请查看实际代码后再做判断。命中的文件会全部列出不做省略;指定 --output 时,除了终端输出外还会以指定格式(根据扩展名自动判断)保存到文件。为防止双击执行等情况下窗口立即关闭,执行结束时会暂停等待按下 Enter 键。
  3. 使用自动转换工具:rector/rector 提供各 PHP 版本的升级规则集(Php74, Php80 … Php84),可以自动完成大部分机械性修改,例如无括号三元运算符、${var} 插值、显式声明 nullable 参数等。先以 dry-run 方式运行 Rector,只手动处理无法自动修复的差异,可大幅缩短时间。
  4. 用静态分析找出“不易察觉的行为变化”:以最高级别运行 PHPStan/Psalm,提前检测出归类为 P1 的“不报错但结果改变”类问题(比较运算符、类型转换等)。
  5. 预发布环境使用 PHP 8.2.35 + 显示全部错误进行验证:一次性升级时 P0 的 Fatal Error 会在最开始集中出现,因此用下面的设置尽早发现。
    php.ini(仅限验证环境)
    display_errors = On
    error_reporting = E_ALL
    log_errors = On
    error_log = /var/log/php_migration_errors.log
  6. 盘点扩展模块:用 php -m 确认当前加载的扩展;如果使用了 8.0 中从核心捆绑中移除的 xmlrpc 等扩展,请将通过 PECL 重新安装纳入计划。
P0 致命错误 放置不管会因致命错误(Fatal/TypeError/ValueError)导致处理中止。 P1 结果不稳定 不报错但结果悄然改变。作为 bug 不易暴露。 P2 其他必须处理 不属于 P0/P1,但官方列为必须(Backward Incompatible)的项目。 P3 推荐处理 已弃用(Deprecated)。目前仍可运行,但将来计划删除。

建议不要按优先级取舍,而是从 P0 开始依次处理全部项目。

P0 — 致命错误(维持现状将无法运行)

P1 — 结果不稳定(行为悄然改变)

P2 — 其他必须处理(必须但不属于 P0/P1)

P3 — 推荐处理(已弃用、目前仍可运行)

参考:全部项目简易对照表(省略示例代码、共 308 项)

上面介绍的约 70 个项目是“影响特别大/特别容易忽略”的精选。这里列出了 versions.html 中的全部项目,包括像 compact() 这样单独看优先级较低的项目。如果您的代码中没有使用相应的函数或写法,则无需处理。

P0 致命错误 — 运行时因 Fatal Error/未捕获异常导致处理中止(- 项) P1 结果不稳定 — 不报错但结果改变或变得不稳定(不易察觉的 bug 温床)(- 项) P2 其他必须处理 — 不属于上述情况,但官方列为必须(Backward Incompatible)的项目(- 项) P3 推荐处理 — 已弃用(Deprecated)。目前仍可运行,但将来计划删除(- 项)

※ P0~P3 是根据各项目(日文)说明中的关键字自动判定的参考值。实际危险程度取决于代码中的使用情况,请仅作参考。建议不要按优先级取舍,从 P0 开始处理全部项目。

按目标版本筛选:
#Ver优先级分类目标功能/函数内容