ThinkPHP 8.1.4 版本发布 —— 兼容 PHP 8.5 及多项优化 第1张本次版本更新聚焦于核心框架与orm层的多项能力升级与缺陷修复，正式支持php 8.5，并在稳定性、运行效率及开发者体验方面实现显著提升。此次迭代也为2025年度的技术演进画上了圆满句点，同时为2026年更多创新特性的落地奠定了坚实基础。

核心更新

? 核心能力强化

  1. Config类增强

    • 优化hook方法逻辑，新增对key参数的原生支持
    • 重构lazy方法实现机制，加快配置项按需加载速度

  2. 路由系统升级

    • 修复URL生成过程中路径拼接异常问题
    • 支持将路由绑定至命名空间时自动识别控制器后缀
    • 强化路由分组下URL有效性校验逻辑
    • 完善中间件参数传递方式，提升链式调用可靠性

  3. 请求与响应优化

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

? 兼容性与性能提升

  1. PHP兼容性适配

    立即学习“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.php.cn/link/155882bd2be6bbd7f2e84ef47700b81a
  • 文档中心：https://www.php.cn/link/151af9b52e3fc571b203d4bf0bc19ea0
  • 社区论坛：https://www.php.cn/link/4ee3a0ca5b398afe5f6c8610ebf49e39
  • 官方智能体：https://www.php.cn/link/5ec0e841773822fb8a32da3460e1f1b2

源码地址：点击下载