本次版本更新聚焦于核心框架与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、save、saveAll等核心方法行为
• 自动验证机制支持字段映射关系，确保业务规则精准执行
• 新增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不断进化。让开发变得更简单，始终是我们坚守的初心。官方已规划在下一版本中引入更具突破性的特性，进一步提升开发效率与工程体验。

官方资源

• 官方网站：https://www./link/155882bd2be6bbd7f2e84ef47700b81a
• 文档中心：https://www./link/151af9b52e3fc571b203d4bf0bc19ea0
• 社区论坛：https://www./link/4ee3a0ca5b398afe5f6c8610ebf49e39
• 官方智能体：https://www./link/5ec0e841773822fb8a32da3460e1f1b2

源码地址：点击下载