NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #3301 most downloaded on Packagist
the PHP Database&ORM Framework
Latest stable
v4.0.51
Last release 11 months ago
18 Dec 2025
Ships unpredictably
gaps range from 8 days to 4 months
Most releases are documented
notes for 52 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
180 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
改进query类的hidden、visible和append处理
value方法和column方法对json字段的支持withattr方法whereJsonContains和whereOrJsonContains方法用于查询json数组数据hidden方法支持隐藏json字段的某个属性columnWithAttr和valueWithAttr方法预载入关联支持在闭包使用withBind方法动态绑定参数到父模型
model类withAttr方法调整为withFieldAttr方法 避免和query类冲突
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
query类增加suffix方法 可以用于关联定义的时候动态设置
修复 autoInsIDType函数 数据库无自增主键情况下报错 Illegal offset type
Nothing published for this version
Query类增加withTrashed方法 用于关联查询的时候指定是否需要包含软删除数据
主要更新: - 修改模型更新方法,默认关闭全局查询范围限制 - 改进whereMonth查询
主要更新:
Nothing published for this version
模型增加autoInc属性用于设置数据表自增主键 支持字符串或true(自动获取主键值)
主要更新包括:
MongoDB驱动增加支持配置builder和query参数,便于开发者自定义Builder和Query类实现
Nothing published for this version
Nothing published for this version
修正反馈的一些问题 为模型新增一个创建查询对象方法 支持 json 类型的 null,not null判断
修正反馈的一些问题 为模型新增一个创建查询对象方法 支持 json 类型的 null,not null判断
改进save方法支持实体对象 添加pgsql版本>12的数据库脚本 去除聚合查询sql加limit 1,和FetchSql生成的sql保持一致 增加BaseBuilder类 修正MongoQuery 调整Connection基类及Fetch类 调整参数绑定机制 修正think\db\connecto
改进save方法支持实体对象 添加pgsql版本>12的数据库脚本 去除聚合查询sql加limit 1,和FetchSql生成的sql保持一致 增加BaseBuilder类 修正MongoQuery 调整Connection基类及Fetch类 调整参数绑定机制 修正think\db\connector\Mongo 改进虚拟模型支持实体对象
- 增加insertAllByKeys方法 - 优化模型嵌套访问一对一关联模型 - 修复模型设置类型转换为array时的bug - 调整json类型转换 - 修改getDeleteTimeField方法权限 - 添加返回类型和参数类型 - 多态类型未定义时,返回null - 改进getSchemaC
修改模型访问多层关联模型的bug 改进php think optimze:schema 指令无需开启fields_cache 取消lazySave方法
修改模型访问多层关联模型的bug 改进php think optimze:schema 指令无需开启fields_cache 取消lazySave方法
改进datetime字段写入 修正autoInsIDType方法 改进toarray方法 改进pgsql驱动 修正自动参数绑定 改进批量数组查询
改进datetime字段写入 修正autoInsIDType方法 改进toarray方法 改进pgsql驱动 修正自动参数绑定 改进批量数组查询
使用match替代switch语法 增加数值字段的延迟写入和同步获取
使用match替代switch语法 增加数值字段的延迟写入和同步获取
Nothing published for this version
模型实例化及data方法支持传入模型对象实例 column方法支持json字段属性
模型实例化及data方法支持传入模型对象实例 column方法支持json字段属性
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
修复关联对象动态设置表后缀之后写入数据时不自动添加数据表后缀的问题
增加insertAllByKeys方法 增加强制更新缓存方法 cacheForce cache方法tag如果不指定默认使用表名 改进mongo builder类 改进saveall方法对多主键的支持
增加insertAllByKeys方法 增加强制更新缓存方法 cacheForce cache方法tag如果不指定默认使用表名 改进mongo builder类 改进saveall方法对多主键的支持
修改模型访问多层关联模型的bug 改进php think optimze:schema 指令无需开启fields_cache
修改模型访问多层关联模型的bug 改进php think optimze:schema 指令无需开启fields_cache
修正autoInsIDType方法 改进toarray方法 修正自动参数绑定 改进数组批量查询
修正autoInsIDType方法 改进toarray方法 修正自动参数绑定 改进数组批量查询
修正关联写入的修改器无效问题 column方法支持json字段属性获取
修正关联写入的修改器无效问题 column方法支持json字段属性获取
修正一对一关联动态绑定关联属性 自动判断关联数据是否存在 模型类setAttr方法自动判断设置关联属性 修正关联自动写入 改进分布式事务 改进json字段多属性更新支持 添加参数自动绑定设置以优化查询性能 修正withJoin方法的闭包查询 调整关联定义对limit的支持 改进关联的limit用法
修正一对一关联动态绑定关联属性 自动判断关联数据是否存在 模型类setAttr方法自动判断设置关联属性 修正关联自动写入 改进分布式事务 改进json字段多属性更新支持 添加参数自动绑定设置以优化查询性能 修正withJoin方法的闭包查询 调整关联定义对limit的支持 改进关联的limit用法
兼容性问题修正 添加getInstance获取所有连接实列 分页类增加 setCollection() 方法 修复时间字段为 0 时,获取到的值为 null 的问题 一对一关联预查寻支持其他关联表字段作为外键
兼容性问题修正 添加getInstance获取所有连接实列 分页类增加 setCollection() 方法 修复时间字段为 0 时,获取到的值为 null 的问题 一对一关联预查寻支持其他关联表字段作为外键
修复 with&bind 调用多次导至前面的 hidden 被替换的问题
当count与group同时使用时,对count传入字段做验证
增加cacheAlways方法 无论数据是否为空都缓存 withField的参数支持数组或字符串 改进setAttr方法对象写入的支持 优化IDE支持 修正field方法 修正Raw查询
增加cacheAlways方法 无论数据是否为空都缓存 withField的参数支持数组或字符串 改进setAttr方法对象写入的支持 优化IDE支持 修正field方法 修正Raw查询
Nothing published for this version
完善sqlite驱动 修正Fetch类 改进多对多关联 添加数据写入对对象值的判断处理 改进一对一关联写入 一对一关联查询绑定属性调整 改进远程一对多关联查询
完善sqlite驱动 修正Fetch类 改进多对多关联 添加数据写入对对象值的判断处理 改进一对一关联写入 一对一关联查询绑定属性调整 改进远程一对多关联查询
Nothing published for this version
Nothing published for this version
改进模型关联查询 模型和Db类的数据处理统一使用Db类filter方法
改进模型关联查询 模型和Db类的数据处理统一使用Db类filter方法
Nothing published for this version
改进db类hidden visible append 方法处理机制
Mongo驱动改进数据库事件 修复 more 方法中当前查询数据空时获取 lastId 会报错的问题 修复自动时间戳int类型 添加修改返回1970 修正transactionXa方法 删除Relation类update和delete方法 修复hasWhere closure为空时foreach报错
Mongo驱动改进数据库事件 修复 more 方法中当前查询数据空时获取 lastId 会报错的问题 修复自动时间戳int类型 添加修改返回1970 修正transactionXa方法 删除Relation类update和delete方法 修复hasWhere closure为空时foreach报错 修复paginate 返回[] 而不是空数据集,而导致的hidden等方法无法调用 fix: 修复php8自动提交事务时的报错 修正hasWhere方法 value和column方法支持json字段和动态获取器 关联定义增加withDefault方法指定关联数据不存在时候的默认值 修复 whereNotBetweenTime 逻辑错误
Nothing published for this version
Nothing published for this version
优化分页查询 改进聚合查询 强化虚拟模型支持 改进关联的withoutfield方法参数支持字符串
优化分页查询 改进聚合查询 强化虚拟模型支持 改进关联的withoutfield方法参数支持字符串
改进模型事件注册 软删除destroy优化 关联支持withoutField方法 改进getValue对动态获取器的处理 改进分页类
改进模型事件注册 软删除destroy优化 关联支持withoutField方法 改进getValue对动态获取器的处理 改进分页类
fixed: 兼容 symfony/cache 组件规则,不能在 key 或 tag 中使用的保留字符 :'{}()/\@:'
修正parseIn方法 改进__unset方法 修正修改数据不生效的问题 完善 column distinct 测试 补充 whereNotIn 测试
修正parseIn方法 改进__unset方法 修正修改数据不生效的问题 完善 column distinct 测试 补充 whereNotIn 测试
修正异常类注解 Connection->link*属性补充类型注解 composer.json 声明 pdo 扩展是必须的 优化独立运行所需的兼容类 完善事务中的断连重试处理,避免数据污染 修复7.4以下版本存在无法把PDO警告转换为异常导致不兼容问题 修正phpunit兼容性 改进获取器
修正异常类注解
Connection->link*属性补充类型注解
composer.json 声明 pdo 扩展是必须的
优化独立运行所需的兼容类
完善事务中的断连重试处理,避免数据污染
修复7.4以下版本存在无法把PDO警告转换为异常导致不兼容问题
修正phpunit兼容性
改进获取器
改进getRealsql方法处理 添加单元测试与github-actions 导出包时忽略掉不必要的文件 增强 column 方法 改进模型的getBindAttr方法和获取器冲突问题 增加获取器场景功能 补充数据集方法 增加模型输出的场景设置功能 支持hidden visible append 改
改进getRealsql方法处理 添加单元测试与github-actions 导出包时忽略掉不必要的文件 增强 column 方法 改进模型的getBindAttr方法和获取器冲突问题 增加获取器场景功能 补充数据集方法 增加模型输出的场景设置功能 支持hidden visible append 改进 WhereIn 空数组查询 改进trigger 改进时间字段写入后实时获取的问题 改进时间字段处理
Nothing published for this version
增加mysql json类型字段->>方式获取支持 模型类型转换处理 不纳入获取器和修改器 时间字段处理调整 增加模型数据输出的映射支持 when方法调整 用于支持在闭包内使用查询条件之外的链式方法 修复 column 方法 field 字段传 '*' 时返回空数组 改进getRealSql方法兼容
增加mysql json类型字段->>方式获取支持 模型类型转换处理 不纳入获取器和修改器 时间字段处理调整 增加模型数据输出的映射支持 when方法调整 用于支持在闭包内使用查询条件之外的链式方法 修复 column 方法 field 字段传 '*' 时返回空数组 改进getRealSql方法兼容性 改进异常捕获 修复命令行生成数据库字段缓存为空的bug 改进时间戳自动写入
改进多对多关联查询 改进数据库的连接异常捕获 改进when条件查询的闭包处理 改进一对一关联查询对order的支持 改进DbException类继承 改进多对多关联查询条件设置 改进只读字段判断 改进where查询 startTrans()方法并未终止抛异常,重连成功终止抛异常 upd: 修改PDO
改进多对多关联查询 改进数据库的连接异常捕获 改进when条件查询的闭包处理 改进一对一关联查询对order的支持 改进DbException类继承 改进多对多关联查询条件设置 改进只读字段判断 改进where查询 startTrans()方法并未终止抛异常,重连成功终止抛异常 upd: 修改PDOConnector抽象方法参数和返回类型,保持与子类一致 Relation类增加getForeignKey和getLocalKey方法 模型类增加convertNameToCamel属性 用于设置模型数据的命名强制采用驼峰命名输出 改进模型getRealFieldName方法
改进BelongsToMany关联 修正whereTime查询对date类型的支持 改进字段缓存文件增加数据库子目录 并支持自定义 改进一对一关联的属性绑定当关联数据不存在的时候的数据格式的一致性 改进mysql驱动 改进多对多关联 改进查询缓存对高并发的支持 改进模型的事务调用 改进DbManag
改进BelongsToMany关联 修正whereTime查询对date类型的支持 改进字段缓存文件增加数据库子目录 并支持自定义 改进一对一关联的属性绑定当关联数据不存在的时候的数据格式的一致性 改进mysql驱动 改进多对多关联 改进查询缓存对高并发的支持 改进模型的事务调用 改进DbManager的connect方法 返回一个connection的代理类,可以保存下来多次使用该连接 改进Raw对象查询的参数绑定机制 改进字段信息缓存纳入缓存机制 修正MorphToMany关联 改进数据库的query和execute方法
模型create、update和saveall方法支持suffix
Nothing published for this version
- 改进模型数据浮点类型转换 - 增加多态多对多关联支持 - mongodb加入事务支持(mongodb版本V4.0+) - 改进insertAll对replace的支持
One column per quarter.