ThinkPHP8.1.4版本发布——兼容PHP8.5及多项优化

2025年的最后一次更新终于来了，这次更新兼容8.5版本，核心框架、ORM以及开发工具都做了不少改进，而且保持向下兼容。给这一年画上了一个不错的句号，也让人期待新一年的更多特性。

核心更新

核心功能增强

先说Config类，hook方法增加了key参数支持，lazy方法的实现也做了调整，配置加载效率有所提升。路由系统这边，修正了URL生成逻辑，路由绑定到命名空间时支持控制器后缀，路由分组的URL有效性检查也改进了，中间件传参机制得到优化。请求响应方面，Request类功能改进，Response类的send方法异常处理能力增强，HttpEnd错误日志记录也做了优化。

兼容性与性能

兼容性上，全面兼容8.5版本，同时调整了“psr/http-message”依赖，增加了对^2.0的支持。缓存与日志部分，Redis缓存驱动性能得到改进，日志文件删除顺序优化，日志处理效率有所提升。

开发工具增强

新增了optimize命令，提供更多优化选项。代码质量方面，CS Fixer配置规则优化，代码规范性和可维护性进一步增强。

ORM更新

同时我们也给ThinkORM4.0带来了大量的优化和改进。

性能优化

引入了LazyCollection惰性数据集，大幅减少内存占用。chunk方法使用lazy重写，大数据量处理性能提升。关联预载入查询用cursor减少内存开销，lazy方法对distinct的处理也做了改进。toArray方法的append处理支持relation.attr方式，Json字段解析效率优化。LazyCollection类增加了page方法简化数据处理，cursor方法支持关联查询，关联预载入查询的limit方法也改进了。PDOConnection类的query和execute方法不再依赖Query，性能更优。

视图模型功能完善

这次视图模型获得了完整的生命周期支持（查询、验证、写入），支持自动关联查询和写入，还有独立的查询范围和搜索器，JSON字段映射和类型转换也安排上了。视图模型支持update和create方法调用并返回当前视图模型，新增了clear、refresh、validate、data等方法。默认支持写入，除非readonly为true（原allowWrite参数废弃）。自动关联查询不再依赖autoMapping定义，会自动检测关联映射。查询条件处理也优化了，可以自动根据视图模型的属性查询，自动关联查询。排序字段支持映射，多级子关联映射问题修复，嵌套关联数据写入改进，获取器调用优化，支持基础类参数定义。data方法支持原有属性和传入对象，一对多关联写入改进，create、update、sa ve、sa veAll等方法也做了优化。自动数据验证支持字段映射，新增validate_mapping_data配置用于设置是否验证映射后的数据。

数据库连接增强

connect方法支持数组配置，数据库驱动增加了时区设置，统一使用timezone参数配置。PostgreSQL驱动完善，使用标准系统表查询字段信息，支持获取字段注解内容。增加了after_connect事件，数据库numberic类型视为字符串类型处理。

关联查询功能增强

一对多关联增加了first和last方法，一对一关联增加了firstOfMany和lastOfMany方法。hasWhere查询条件支持更多数组用法，关联写入支持JSON字段映射，belongsTo关联的hasWhere方法也修正了。

模型功能增强

模型增加了scene方法用于设置自动验证的场景，模型和实体模型增加了基础配置定义方法getBaseOptions()，新增setAttrs、getAutoInc等方法。suffix方法调用处理改进，getPk方法支持没有主键的表。模型类和数据集对象增加了toView方法，autoWriteData方法对于手动写入的自动写入时间字段不再生成。destroy方法增加了together参数，Model类的get方法、__isset、__unset、__unserialize方法都做了改进。去掉了Model类的autoinc处理，实体模型和视图模型的newInstance和setModel方法改进，视图模型的clone、refresh方法优化，查询字段自动识别也改进了。

查询功能改进

增加了lazy惰性查询方法，预载入关联查询使用lazy方法。新增stream流式处理方法，支持流式回调。hasWhere查询条件支持更多数组用法，join查询方法多次调用改进，parserOrder方法支持json字段排序，getOrigin方法增加了类型转换参数。

问题修复

修正了DateTime类关闭时间格式化后的问题，支持写入null。软删除功能修正，chunk方法主键不存在时查询出错问题修复，OptimLock的getDbWhere方法参数默认值修正，order方法传数组的别名问题修复，chunk查询中断问题修复，mongo游标查询问题修复，修改器的data参数修正，update方法的刷新数据改进。

安装与升级

全新安装
composer create-project topthink/think tp

升级现有项目
composer update topthink/framework

注意事项

1. 本次更新为常规维护版本，保持向下兼容。
2. 建议在测试环境中验证后再部署到生产环境。
3. 如遇到任何问题，请访问官方文档或提交Issue。