codeigniter 官方 2026 年 2 月 1 日发布了 4.7.0 版本。这次更新直接把最低要求的 php 版本升到 8.2,还新增了实验性的 frankenphp worker mode 支持。打算升级的团队注意,先把服务器 php、用到的扩展、部署脚本还有常驻进程的兼容性都核对一遍,比直接替换 composer 依赖要紧得多。

来源:CodeIgniter 官方用户指南
Worker Mode 的作用是让应用在 FrankenPHP 工作进程里持续运行,省去每次请求重复引导框架的开销。不过官方明确标了这是实验性功能,千万别直接把标称的理论性能当成生产环境的实际效果,一定要先在压测或者灰度环境做足验证。常驻进程会直接改变资源的生命周期,静态状态、单例服务、数据库连接以及请求结束后的清理逻辑,全都要拿真实负载场景逐一检查。

来源:CodeIgniter 官方用户指南
为了降低配置门槛,4.7.0 新增 php spark worker:install 命令,直接生成 FrankenPHP Worker Mode 所需的 Caddyfile 与 worker 入口文件。不过生成文件只是第一步,部署人员还是要检查端口、环境变量、日志、进程重启和健康检查规则,确认和现有基础设施匹配。如果你的应用依赖请求级初始化,也得确认相关对象不会在多个请求之间遗留状态,引发隐式bug。

来源:CodeIgniter 官方用户指南
升级影响不只是 PHP 版本要求。regex_match 验证规则中的占位符现在改成了双花括号,避免和正则量词用的单花括号混淆;insertBatch() 和 updateBatch() 现在会严格遵循 updateOnlyChanged、allowEmptyInserts 等模型设置。主键值也会在数据库查询前做更明确的校验,非法值抛出的异常类型和时机都和之前不一样,依赖旧异常分支做处理的代码需要重新测试。

来源:CodeIgniter 官方用户指南
实体变化检测也从浅层比较改成了更深度的规范化比较,覆盖嵌套数组、对象、枚举、日期时间、可遍历集合和嵌套实体。之前只修改对象内部属性、没被框架识别到变更的场景,在 4.7.0 里可能会被标记为已修改。Content Security Policy 也新增了配置项,升级时记得对照当前项目的 app/Config/ContentSecurityPolicy.php 合并改动,别直接用新版文件整份覆盖之前的定制内容。

来源:CodeIgniter 官方用户指南
最稳妥的迁移顺序是,先把运行环境升级到 PHP 8.2,处理完验证规则、模型主键和实体比较的行为变化之后,再单独评估 Worker Mode。把常规框架升级和实验性运行模式拆成两个可独立回滚的步骤,更容易定位兼容性问题,也能避免性能测试结果被其他代码变更干扰。











