ThinkPHP6.0如何更新数据_ThinkPHP6.0数据修改【常用】

在实际开发中，数据更新操作是最常见的需求之一。但很多开发者在使用ThinkPHP6.0时，对update()和sa ve()的选择往往存在困惑——该用哪个，什么时候用，用错了会出什么问题？这里先给出几个核心判断。

ThinkPHP6.0更新数据首选update()静态方法，适合条件更新且不依赖实例；sa ve()需先查出模型实例，用于触发事件、验证及基于原值计算；批量更新慎用sa veAll()，推荐update()或原生SQL。

首先要明确一点：ThinkPHP6.0 更新数据不能只依赖 sa ve()，特别是在没有先查出模型实例就直接修改的场景下，它要么报错，要么静默失败，让你在调试时一头雾水。

update()，适合条件更新且不依赖实例

这是最常用、也最稳妥的更新方式。适合“知道条件、不关心原值”的场景——比如后台编辑表单提交后，直接按 ID 更新。

• update() 是模型级别的静态方法，不需要先加载实例，也不会触发模型事件（如 before_update），因此性能更高、逻辑也更清晰
• 写法有两种：传两个参数（数据 + 条件），或者链式调用 where() 后跟 update()
• 返回值是影响行数（int），为 0 表示没匹配到数据，这不是错误，但需要你主动判断
• 如果数据里带了主键（比如 ['id'=>1, 'name'=>'新名字']），update() 会自动把它当作条件，不过还是建议显式写 where，更可控

示例：

// 推荐：显式 where + update
$result = User::where('id', $id)->update(['name' => $name, 'email' => $email]);

// 或者：数组式写法（等价）
$result = User::update(['name' => $name, 'email' => $email], ['id' => $id]);

if ($result === 0) {
    // 注意：是 0，不是 false！说明没找到对应记录
    throw new \think\Exception('用户不存在');
}

sa ve()，查出来再改的完整流程

换个场景：你需要触发模型事件、自动验证、软删除逻辑，或者要基于原值做计算（比如阅读数 +1），这时就必须先查出模型实例，再调用 sa ve()。

• sa ve() 只能作用于已存在的模型对象，否则会抛出 Integrity constraint violation 主键冲突错误
• 修改字段后调用 sa ve()，默认只更新有变化的字段；如果想让所有字段都写入（哪怕值没变），需要加上 force()
• 如果某个字段需要执行 SQL 函数（比如 score = score + 1），必须用 Db::raw() 包裹。直接赋值为字符串会被当作字面量处理，结果就是字段值被覆盖成字符串“score + 1”，这个坑踩的人不少

示例：

$user = User::find($id);
if (!$user) {
    throw new \think\Exception('用户未找到');
}

$user->name = $name;
$user->score = Db::raw('score + 1'); // 不是 'score + 1'
$user->sa ve(); // 只更新 name 和 score 字段

// 强制更新全部字段（含未变的）
$user->force()->sa ve();

批量更新必须用主键，不能混用条件

sa veAll() 看起来确实方便，但限制很多，线上环境要慎用。

• 只支持按主键更新：传入的数据数组中，每个元素必须包含主键字段（如 'id'），否则该条数据会被跳过
• 不支持任意 where 条件，也不能对非主键字段做批量条件更新。比如“把所有 status=0 的用户改成 1”，这种情况只能用 update()
• 返回的是数据集对象，不是影响行数，调试时容易误判是否成功
• 如果某条数据主键冲突或验证失败，整个 sa veAll() 不会中断，但对应那条数据不会生效——需要自己遍历检查

示例：

$list = [
    ['id' => 1, 'name' => '张三', 'status' => 1],
    ['id' => 2, 'name' => '李四', 'status' => 1],
];

$result = User::sa veAll($list); // 成功返回数据集，失败条目静默忽略

// 检查是否都写入了？
foreach ($result as $item) {
    if (!$item->id) {
        // 这条没保存成功
    }
}

别踩这些坑

实际开发中最容易翻车的地方，往往不在语法，而在语义和边界处理上。

• update() 和 sa ve() 都不会校验字段是否存在。字段名写错了，只会默默忽略（除非开启了严格模式）
• 用 Db::raw() 更新时，如果字段本身是 NULL，score + 1 的结果还是 NULL。正确的做法是 IFNULL(score, 0) + 1
• 模型的 allowField() 对 update() 无效，只作用于 sa ve()。想在 update() 中控制可写字段，需要在调用前手动过滤数组
• 事务中混合使用 update() 和 sa ve() 时，事件的触发时机不同，可能导致日志、缓存清理等副作用被遗漏

真正复杂的更新逻辑——比如跨表、带子查询、条件分支多的情况——建议直接用 Db::execute() 写原生 SQL，比绕模型更可控。模型不是银弹，只是工具，选对场景比记语法更重要。