本次版本更新聚焦于核心框架与orm层的多项能力升级与缺陷修复，正式支持php 8.5，并在稳定性、运行效率及开发者体验方面实现显著提升。此次迭代也为2025年度的技术演进画上了圆满句点，同时为2026年更多创新特性的落地奠定了坚实基础。
核心更新
? 核心能力强化
-
Config类增强
- 优化hook方法逻辑，新增对key参数的原生支持
- 重构lazy方法实现机制，加快配置项按需加载速度
-
路由系统升级
- 修复URL生成过程中路径拼接异常问题
- 支持将路由绑定至命名空间时自动识别控制器后缀
- 强化路由分组下URL有效性校验逻辑
- 完善中间件参数传递方式，提升链式调用可靠性
-
请求与响应优化
- 扩展Request类功能边界，增强数据解析灵活性
- 增强Response类send方法的容错能力，避免因异常中断响应流程
- 改进HttpEnd阶段错误日志记录粒度与上下文完整性
? 兼容性与性能提升
-
PHP兼容性适配
立即学习“PHP免费学习笔记（深入）”；
- 全面通过PHP 8.5兼容性测试并正式支持
- 升级"psr/http-message"依赖至"^2.0"版本范围，确保协议规范一致性
-
缓存与日志模块优化
- 提升Redis缓存驱动的数据读写吞吐量
- 调整日志文件清理策略，优化删除顺序以降低I/O压力
- 加快日志格式化与落盘处理效率
?️ 开发工具升级
-
命令行功能拓展
- 新增
optimize命令，集成多维度项目优化选项（如类映射、配置合并等）
- 新增
-
代码质量治理
- 更新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
注意事项
- 本次发布属于常规维护版本，严格遵循向下兼容原则
- 强烈建议先在测试环境完成完整回归验证，再推进至生产环境
- 若发现任何异常或疑问，欢迎查阅官方文档或前往GitHub提交Issue
致谢
衷心感谢每一位为ThinkPHP贡献代码、提出建议与持续反馈的Tper！正是你们的热情参与与专业精神，推动着ThinkPHP不断进化。让开发变得更简单，始终是我们坚守的初心。官方已规划在下一版本中引入更具突破性的特性，进一步提升开发效率与工程体验。
官方资源
- 官方网站：https://www.php.cn/link/155882bd2be6bbd7f2e84ef47700b81a
- 文档中心：https://www.php.cn/link/151af9b52e3fc571b203d4bf0bc19ea0
- 社区论坛：https://www.php.cn/link/4ee3a0ca5b398afe5f6c8610ebf49e39
- 官方智能体：https://www.php.cn/link/5ec0e841773822fb8a32da3460e1f1b2
源码地址：点击下载
