PHP 运行时迁移：扩展加载、错误级别与框架适配

PHP 的版本升级很容易受到运行时扩展和配置文件的影响。命令行环境、Web 进程和后台脚本可能加载不同的 ini 文件，因而出现“本地正确、线上异常”的现象。迁移应先建立各执行入口的配置快照，再逐步验证语言兼容、框架依赖和扩展加载。

采集每个入口的运行时快照

分别从命令行、Web 请求和任务进程输出 PHP 版本、已加载配置文件、已启用扩展与关键配置。升级候选运行时后再次采集并比较，重点关注字符编码、时区、错误报告、内存限制与上传限制等配置。若不同入口配置不一致，应在迁移前先解释差异来源；否则错误很可能被误归因给新版本。

扩展兼容性比语法兼容更先暴露

数据库驱动、缓存扩展、图像处理、消息协议和调试扩展常需要与特定 PHP 版本匹配。应在干净镜像或干净主机中安装目标扩展，确认加载成功，再执行连接、读写和异常分支测试。不要只检查扩展列表；某些扩展能加载但在特定算法或字符输入下失败。对原生扩展问题，保留构建日志、系统库版本和运行时错误，便于进一步定位。

用错误报告发现隐性不兼容

候选环境中应在测试阶段启用足够的错误报告，收集弃用与警告信息，再按应用代码和依赖代码分开处理。典型敏感点包括动态属性、参数类型、字符串偏移、数组键和异常处理。修改代码时，应补充能表现旧问题的最小用例，而不是仅把报错位置改到能通过。这样未来再次升级时仍能验证修订目的。

框架命令与请求链路都要测试

框架的缓存构建、路由发现、队列消费者、模板编译和数据库迁移命令可能调用不同依赖。验证时至少执行一次完整安装、配置缓存、应用启动、典型请求和后台任务。若有多站点或多租户配置，也应选择代表性配置覆盖。对输出给其他系统的 JSON、日期和数值格式进行比较，避免细微变化扩散到接口边界。

部署策略应避免配置与运行时同时大改

优先让运行时版本变更与大规模配置重构分开，发布后观察错误日志、延迟和任务处理情况，并准备上一镜像回退。PHP 支持周期、扩展可用版本与框架约束会变化，请依据执行时的发布信息确认最终组合。

当不同入口的配置、扩展实际能力和框架工作流都被验证后，PHP 迁移才有清晰的证据基础。