php5.6 升级到 php8.3.36 踩的一些坑

最近 php 爆出了 9.3 分的严重漏洞，我负责的一个项目 php 版本是 5.6 ，之前也一直想把它升级到 7 以上的版本，但是觉得改动太大就没有动它。这次不得不升级了。

第一步：本地搭建 php8.3.36 环境，然后用 claude code 做兼容性检查修复并导出 excel 文件,共检查出 284 出不兼容，常见的问题是：数据库返回类型、des 加密、已移除函数、类型错误问题。

第二步：搭建和生产环境一样的测试环境，测试覆盖常用业务。

第三部：在生产环境通过 remi 安装 php8.3.36 。另外新建目录将修改后的代码上传到该目录。新建 apache 配置，将 prod-test 域名指向该配置。测试无误后把项目入口文件内容改成系统升级中提示，然后上传最新代码到项目文件。上传完成后把 apache 配置 php mod 改成 8.3 。然后重启 apache 完成升级。

升级后遇到的几个问题
第一：php5.6 不受 apache 配置 Timeout 的影响，而 php8.3 则会。上线后后台做大数据导出统计时报：The server is temporarily unable to service your request due to maintenance downtime or capacity problems. 后面将 apache Timeout 改成 120s 解决。

第二：升级后系统定时任务执行失败，通过执行：grep -E 'CROND.*CMDOUT|CROND.*CMD' /var/log/cron | tail -50 查出 cron 任务执行时 php 指向的还是 php5.6,后面将任务里的 php 改成 php8.3 解决。

第三：array_multisort 数组排序在 php8.3 中报错 Array sizes are inconsistent ，原因时多个数组元素数量不一致导致。

第四：json 解析时会报：json_decode(): Argument #1 ($json) must be of type string, 处理方案时解析前判断参数是否为字符串和是否为空。

总结：从周漏洞爆发到周日升级，总共用时 3 天解决。现在有 ai 辅助，修改代码比之前简单多了，但是 ai 也不是万能的，像类型定义错误、json 解析和数组问题 ai 都没有检查出来。以前觉得从 5.6 升级到 8.3 一定会困难重重，但是一旦开始执行，一个个问题解决也发现其实也很容易就处理了。

SoulFlame

4 小时 31 分钟前

@ModiKa2022 #3
@cbasil #5 项目升级 PHP 大版本有很多不可控的因素的，升级完成到百分百覆盖测试，其实需要很多功夫，如果测试不到位，有一定规模的项目，如果数据库产生了脏数据，那后果将是灾难性的。
而且如果此漏洞易利用的话，在你升级这段时间，你的项目是暴露在非常大的风险之中（幸运的是此次漏洞虽然危害大，但是并不容易利用）。

所以我个人还是更赞成第一时间紧急做对应 PHP 版本的补丁修复（这可能只需要花费你 1-2 个小时）。后续再慢慢做 PHP 大版本升级。