当前位置：首页 > 全部内容 > ThinkPHP6.0数据更新操作详解

ThinkPHP6.0数据更新操作详解

作者：技术拾光时间：2026-06-20 10:35:13浏览：298

ThinkPHP6数据更新推荐使用模型`save()`方法，能触发事件、自动处理时间戳并支持验证。直接调用`update()`或`Db::table()-where()-update()`虽快，但会绕过模型机制，存在隐患。软删除数据需用`withTrashed()`或关闭全局作用域才能更新。模型方法与`Db`类操作混用易致状态不一致。

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

ThinkPHP6.0数据更新操作详解

用 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() 才是正解，别贪那点所谓的“性能优化”。