在 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+)”的形式注明适用的补丁版本)。
rector 等自动转换工具难以发现的设计判断(PDO 错误模式变更、@ 运算符行为变化、资源→对象的类型判断变化等)。在核对全部 308 项之前先在这里掌握思路,有助于正确判断后续工具的输出。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
--output 时,除了终端输出外还会以指定格式(根据扩展名自动判断)保存到文件。为防止双击执行等情况下窗口立即关闭,执行结束时会暂停等待按下 Enter 键。
rector/rector 提供各 PHP 版本的升级规则集(Php74, Php80 … Php84),可以自动完成大部分机械性修改,例如无括号三元运算符、${var} 插值、显式声明 nullable 参数等。先以 dry-run 方式运行 Rector,只手动处理无法自动修复的差异,可大幅缩短时间。display_errors = On error_reporting = E_ALL log_errors = On error_log = /var/log/php_migration_errors.log
php -m 确认当前加载的扩展;如果使用了 8.0 中从核心捆绑中移除的 xmlrpc 等扩展,请将通过 PECL 重新安装纳入计划。建议不要按优先级取舍,而是从 P0 开始依次处理全部项目。
上面介绍的约 70 个项目是“影响特别大/特别容易忽略”的精选。这里列出了 versions.html 中的全部项目,包括像 compact() 这样单独看优先级较低的项目。如果您的代码中没有使用相应的函数或写法,则无需处理。
※ P0~P3 是根据各项目(日文)说明中的关键字自动判定的参考值。实际危险程度取决于代码中的使用情况,请仅作参考。建议不要按优先级取舍,从 P0 开始处理全部项目。
| # | Ver | 优先级 | 分类 | 目标功能/函数 | 内容 |
|---|