本文旨在深入探讨 Eloquent ORM 中 update() 方法的行为特性，特别是其在更新指定字段的同时，可能意外更新模型实例上已修改（脏）但未明确传入 update() 方法的属性。我们将分析其内部工作机制，并提供一种推荐的解决方案，即通过直接使用查询构建器进行更新，以确保仅更新目标字段，同时讲解如何保持模型实例与数据库同步。
Eloquent update() 方法的默认行为解析
在使用 eloquent orm 进行数据更新时，开发者常会遇到一个不符合直觉的现象：当通过模型实例调用 update() 方法并传入特定字段进行更新时，模型实例上在此之前被修改但未传入 update() 方法的“脏”属性也可能一并被更新到数据库中。
考虑以下代码示例：
$user = User::find(1); // 从数据库加载用户$user->is_admin = 1; // 修改了 is_admin 属性，但尚未保存$user->update(['first_name' => 'Alex']); // 意图只更新 first_name// 结果：is_admin 字段也可能被更新为 1！
为什么会发生这种情况？原因在于 Eloquent Model 类的 update() 方法的内部实现。根据其源代码定义，update() 方法首先会调用 fill() 方法将传入的属性填充到模型实例中，然后紧接着调用 save() 方法。
/** * Update the model in the database. * * @param array $attributes * @param array $options * @return bool */public function update(array $attributes = [], array $options = []){ if (! $this->exists) { return false; } return $this->fill($attributes)->save($options);}
save() 方法的职责是保存模型实例的所有“脏”属性（即与从数据库加载时或上次保存后相比发生变化的属性）到数据库。因此，当 update() 方法被调用时，它不仅会保存传入 attributes 数组中的字段，还会将模型实例中所有在 update() 调用之前被修改过的其他属性一并保存。在上述示例中，$user->is_admin = 1; 这行代码已经将 is_admin 标记为“脏”属性，因此在 update([‘first_name’ => ‘Alex’]) 执行时，is_admin 也会被 save() 方法更新到数据库。
解决方案：使用查询构建器进行精确更新
为了避免这种意外的副作用，确保只更新指定的字段，推荐的方法是绕过模型实例的 save() 行为，直接使用 Eloquent 的查询构建器（Query Builder）进行更新。这样可以精确控制哪些字段会被修改。
$user = User::find(1); // 从数据库加载用户$user->is_admin = 1; // 此时模型实例的 is_admin 属性已被修改// 使用查询构建器直接更新数据库，只影响指定的字段User::whereKey($user->getKey())->update(['first_name' => 'Alex']);// 此时数据库中只有 first_name 被更新，is_admin 保持不变（除非之前就是1）// 但请注意，内存中的 $user 实例的 first_name 仍是旧值，is_admin 仍是 1
重要注意事项：模型实例与数据库同步
当使用 User::whereKey($user->getKey())->update(…) 这种方式进行更新时，数据库中的记录会被修改，但内存中 $user 变量所引用的模型实例并不会自动更新以反映这些变化。如果后续操作依赖于 $user 实例的最新状态，你需要手动同步它。
有两种主要的同步方式：
手动更新模型实例的属性：如果你知道哪些字段被更新了，可以直接设置模型实例的属性。同时，为了确保模型实例的“脏”状态正确，可以调用 setOriginalAttribute() 来更新其原始属性值。
$user = User::find(1);$user->is_admin = 1;User::whereKey($user->getKey())->update(['first_name' => 'Alex']);// 手动更新内存中的模型实例$user->first_name = 'Alex';// 可选：更新原始属性以清除其“脏”状态，防止后续意外保存$user->setOriginalAttribute('first_name', 'Alex');// 此时 $user->first_name 已经是 'Alex'
刷新模型实例：如果你不确定哪些字段被更新了，或者更新逻辑复杂，可以使用 refresh() 方法重新从数据库加载模型实例的最新数据。这会产生一次额外的数据库查询。
$user = User::find(1);$user->is_admin = 1;User::whereKey($user->getKey())->update(['first_name' => 'Alex']);// 重新从数据库加载最新数据到模型实例$user->refresh();// 此时 $user->first_name 已经是 'Alex'，is_admin 保持数据库中的原值
请注意，虽然 refresh() 会产生额外查询，但在某些复杂场景下，它可能是最稳健的同步方式。
总结
Eloquent 的 update() 方法在模型实例上调用时，会将其内部所有已修改（脏）的属性一并保存。如果需要精确控制只更新传入的特定字段，而不触及模型实例上其他已修改的属性，则应使用查询构建器（例如 Model::whereKey($id)->update([…])）进行更新。在使用查询构建器更新后，务必记住手动同步内存中的模型实例，或者通过 refresh() 方法重新加载以确保数据一致性。理解这些细微差别对于编写健壮和可预测的 Eloquent 代码至关重要。
以上就是深入理解 Eloquent update() 方法：避免意外更新脏数据的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1290093.html
微信扫一扫 
支付宝扫一扫 
