ThinkPHP 8.1.4发布 兼容PHP 8.5及多项优化

这次版本更新，重心放在核心框架和ORM层的能力升级和问题修复上。最直观的变化是正式支持了PHP 8.5，稳定性、运行效率、开发者体验都有明显提升。算是对2025年技术演进的一个漂亮收尾，也为2026年更多新特性打下了基础。

核心更新

核心能力强化

1. Config类增强

   • hook方法逻辑做了调整，现在原生支持key参数，按需加载配置项时速度更快
   • lazy方法实现机制重构，配置项加载更高效

2. 路由系统升级

   • 修复了URL生成时路径拼接异常的问题
   • 路由绑定到命名空间时，现在能自动识别控制器后缀
   • 路由分组下的URL有效性校验逻辑更强了
   • 中间件参数传递方式完善，链式调用更可靠

3. 请求与响应优化

   • Request类的功能边界扩展，数据解析更灵活
   • Response类的send方法容错能力增强，不再因为异常中断响应流程
   • HttpEnd阶段的错误日志记录粒度更细，上下文也更完整

兼容性与性能提升

1. PHP兼容性适配

   • 全面通过PHP 8.5兼容性测试并正式支持
   • 升级"psr/http-message"依赖至"^2.0"版本范围，协议规范一致性有保证

2. 缓存与日志模块优化

   • Redis缓存驱动的读写吞吐量提升
   • 日志文件清理策略调整，优化删除顺序，降低I/O压力
   • 日志格式化和落盘处理效率加快

开发工具升级

1. 命令行功能拓展

   • 新增 optimize 命令，集成了多维度项目优化选项（类映射、配置合并等）

2. 代码质量治理

   • 更新PHP CS Fixer规则集，覆盖更严格的编码风格与安全实践
   • 代码可读性、可维护性、团队协作效率都上了一个台阶

ORM更新

ThinkORM 4.0这次是真正的大规模重构，功能补全，能力全方位跃迁。

性能深度优化

• 引入LazyCollection惰性集合机制，大数据集的内存占用大幅降低
• 用lazy重写了chunk方法，海量数据分块处理性能显著提升
• 预加载关联查询默认启用cursor游标模式，内存峰值压力减小
• 改进了lazy方法对distinct语义的支持准确性
• toArray中append字段处理逻辑优化，支持relation.attr嵌套语法
• JSON字段序列化与反序列化速度加快
• 为LazyCollection新增page方法，分页场景下的数据操作更简洁
• 增强cursor方法对关联查询的支持能力
• 改进了预加载关联查询中limit限制行为的合理性
• 重构PDOConnection类的query与execute方法，解除对Query对象的硬依赖

视图模型（View Model）功能完善

• 实现完整的生命周期管理：涵盖查询、验证、写入全流程
• 支持自动触发关联查询与级联写入操作
• 提供独立的查询作用域（scope）与搜索器（searcher）机制
• 完善JSON字段映射与类型自动转换能力
• update与create方法调用后返回当前视图模型实例，便于链式操作
• 新增clear、refresh、validate、data等实用方法
• 默认开启写入权限，仅当显式设置readonly = true时禁用（原allowWrite参数已弃用）
• 自动检测并建立关联映射，无需依赖autoMapping手动声明
• 查询条件自动适配视图模型属性，智能触发关联查询
• 排序字段支持别名映射，SQL可读性与灵活性提升
• 解决多级子关联映射失效问题
• 增强嵌套关联数据写入的健壮性与一致性
• 优化获取器（accessor）调用时机与上下文传递
• 支持基础类参数定义，提高复用性与扩展性
• data方法兼容原有属性结构与外部传入对象
• 改进一对多关联写入逻辑，保障数据完整性
• 全面升级create、update、sa ve、sa veAll等核心方法行为
• 自动验证机制支持字段映射关系，确保业务规则精准执行
• 新增validate_mapping_data配置项，控制是否对映射后数据执行验证

数据库连接能力增强

• connect方法支持直接传入数组形式的连接配置
• 统一各数据库驱动的时区配置入口，统一使用timezone参数
• PostgreSQL驱动全面升级：采用标准系统表获取字段元信息
• 补充pgsql驱动对字段注释（comment）内容的读取能力
• 新增after_connect事件钩子，便于连接后定制化处理
• 将数据库numeric类型统一按字符串处理，规避精度丢失风险

关联查询能力拓展

• 一对多关联新增first与last快捷方法
• 一对一关联新增firstOfMany与lastOfMany语义化方法
• 增强hasWhere条件构造能力，支持更丰富的数组表达式
• 关联写入支持JSON字段映射，打通复杂结构持久化路径
• 修复belongsTo关联中hasWhere方法的行为异常

模型能力增强

• 模型新增scene方法，用于精细化控制验证场景
• 模型与实体模型新增getBaseOptions()基础配置定义接口
• 新增setAttrs、getAutoInc等辅助方法，丰富操作维度
• 优化suffix方法调用逻辑，避免命名冲突与误判
• getPk方法增强兼容性，支持无主键表的正常识别
• 模型类与数据集对象新增toView方法，支持无缝转为视图模型
• autoWriteData方法改进：手动指定时间字段时不重复生成
• destroy方法新增together参数，控制关联资源是否同步销毁
• 重构Model类get方法，提升单条记录获取稳定性
• 增强Model类__isset、__unset、__unserialize魔术方法健壮性
• 移除Model类内置autoinc逻辑，交由驱动层统一处理
• 优化实体模型与视图模型的newInstance和setModel方法行为
• 改进视图模型clone与refresh方法，保障状态一致性
• 提升视图模型字段自动识别准确率，减少手动声明依赖

查询功能升级

• 新增lazy惰性查询入口，支持延迟执行与流式消费
• 预加载关联查询默认采用lazy方式，兼顾性能与内存友好性
• 新增stream流式处理方法，支持逐条回调处理，适用于超大数据集
• 进一步拓展hasWhere条件支持的数组语法多样性
• 改进join多次调用时的别名管理与SQL生成逻辑
• parserOrder方法支持JSON字段路径排序，拓展排序维度
• getOrigin方法新增类型转换参数，增强原始值还原能力

问题修复清单

• 修复DateTime类关闭格式化后无法正确写入null值的问题
• 修正软删除（SoftDelete）功能在特定条件下失效问题
• 解决chunk方法在主键字段缺失时引发的查询异常
• 修复OptimLock组件中getDbWhere方法默认参数不生效问题
• 修复order方法传入数组时别名解析错误
• 解决chunk查询中途终止导致资源未释放问题
• 修复MongoDB游标查询在某些场景下无法正确遍历问题
• 修正修改器（mutator）中data参数传递逻辑
• 优化update方法的数据刷新机制，确保变更后状态同步

安装与升级

全新项目初始化

composer create-project topthink/think tp

现有项目升级

composer update topthink/framework

注意事项

1. 本次发布属于常规维护版本，严格遵循向下兼容原则
2. 强烈建议先在测试环境完成完整回归验证，再推进至生产环境
3. 若发现任何异常或疑问，欢迎查阅官方文档或前往GitHub提交Issue

致谢

衷心感谢每一位为ThinkPHP贡献代码、提出建议与持续反馈的Tper！正是你们的热情参与与专业精神，推动着ThinkPHP不断进化。让开发变得更简单，始终是我们坚守的初心。官方已规划在下一版本中引入更具突破性的特性，进一步提升开发效率与工程体验。