说到 ThinkPHP6 的数据更新,其实核心就一句话:用 sa ve() 配合主键是最稳的。直接调 update() 或写 Db::table()->where()->update() 虽然快,但容易踩坑——模型事件、自动时间戳、验证逻辑,这些机制都可能被绕过去,隐患不小。

用 sa ve() 更新单条记录——标准路径
这才是模型层最推荐的更新方式。它会触发 updating/updated 事件,自动处理 update_time,也支持验证和修改器,相当于走完了一整套规范的流程。
用的时候有几点要注意:
- 模型必须设置好主键(
$pk),而且数据里要有这个主键值,比如id - 只传你需要更新的字段就行,没传的字段不会被清空或覆盖
- 如果主键没在数据里出现,
sa ve()会默认当成插入操作——除非你显式指定isUpdate
$user = new User(); $user->id = 123; $user->nickname = 'newname'; $user->score = $user->score + 10; // 支持表达式,但需要手动处理时间戳或开启 auto_write_timestamp $user->sa ve(); // 自动识别为更新
Db::table() 批量更新——绕开模型,省事但有代价
后台脚本、定时任务这些场景,经常不需要模型那一套钩子,直接操作数据库更爽快。但代价也很明显:不触发任何模型事件,也不校验字段合法性,相当于裸写SQL。
where()条件一定要写明确,线上环境更新前加个limit(1)测试一下,防止误更新整张表- 时间字段要手动赋值,比如
'update_time' => date('Y-m-d H:i:s') - 数字自增得写成
['score' => Db::raw('score + 10')],不能直接写表达式
Db::table('user')
->where('status', 0)
->update([
'status' => 1,
'update_time' => date('Y-m-d H:i:s')
]);
update() 方法的两个暗坑
这个方法容易让人摸不着头脑。它不是模型方法,也不是查询构造器方法,而是 Query 类的静态快捷入口,行为上容易混淆。
几个典型问题:
- 调用
User::update(['id'=>1, 'name'=>'x']),如果id是主键且存在,才会更新;否则静默失败,不报错 - 它不走
sa ve()的流程,验证、事件、修改器统统跳过,但会尝试写入update_time(取决于配置) - 批量更新时,必须显式传
where数组,比如User::update(['status'=>1], ['id'=>['in',[1,2,3]]]),否则只会更新第一条匹配的记录
软删除后还能更新吗?
能更新,但要走点弯路。默认情况下,update() 和 sa ve() 都会自动追加 delete_time IS NULL 条件,也就是说,已软删除的记录,常规更新打不中它。
- 想更新软删除数据,得先用
withTrashed():User::withTrashed()->where('id', 1)->sa ve(['note'=>'restored']) - 或者临时关闭软删除:
User::withoutGlobalScope('SoftDelete')->where('id', 1)->update([...]) - 特别留意:软删除字段本身(
delete_time)不能用普通sa ve()清空,得用restore()或原生 SQL 才行
真正容易翻车的,是模型方法和 Db 类操作混着用。比如在一个事务里先 $model->sa ve(),转头又调 Db::table()->where()->update(),后者绕过了模型缓存和事件,很容易导致状态不一致。更新逻辑一旦复杂了,老老实实走模型 sa ve() 才是正解,别贪那点所谓的“性能优化”。
