本文深入探讨了 Eloquent ORM 中 update() 方法的一个常见行为：当通过模型实例调用 update() 并传入特定字段时，模型上预先修改但未保存的“脏”属性也可能被一同持久化。文章将解析此行为的底层原因，并提供一种精确更新指定字段、同时忽略其他“脏”属性的解决方案，即通过静态查询 where()->update() 来实现，并指导如何同步模型实例状态。
Eloquent update() 方法的行为解析
在使用 eloquent orm 进行数据更新时，开发者常会遇到一个行为上的细微之处：通过模型实例调用 update() 方法时，除了传入的特定字段外，模型实例上所有在当前操作前被修改但尚未保存的“脏”属性也会被一同持久化到数据库。
这一行为的根源在于 Eloquent Model 类的 update() 方法的内部实现。根据其源代码定义，update() 方法实际上是在当前模型实例上先调用 fill() 方法填充传入的属性，然后紧接着调用 save() 方法。save() 方法的职责是将模型实例上所有被修改过的属性（即“脏”属性）写入数据库。
考虑以下代码示例：
$user = User::find(1);// 修改了 is_admin 属性，使其成为“脏”属性$user->is_admin = 1;// 调用 update() 方法更新 first_name$user->update(['first_name' => 'Alex']);// 此时，数据库中的 user 记录的 is_admin 字段也会被更新为 1，// 而不仅仅是 first_name 字段。
在这个例子中，$user->is_admin = 1; 操作使得 $user 实例的 is_admin 属性变为“脏”属性。当随后的 $user->update([‘first_name’ => ‘Alex’]); 被执行时，它会先将 first_name 填充到模型，然后由于内部调用了 save()，所有在 $user 实例上被标记为“脏”的属性（包括 is_admin）都会被一同保存到数据库。这可能与开发者的预期——只更新 first_name——不符。
精确更新指定字段的策略
为了实现只更新指定字段，同时完全忽略模型实例上其他“脏”属性的目的，我们应该避免使用模型实例的 update() 方法，而是采用静态查询的方式直接对数据库进行更新操作。
推荐的解决方案是利用 Eloquent 模型的 where() 和 update() 静态方法组合：
$user = User::find(1);// 假设我们仍然在实例上修改了 is_admin，使其变为“脏”属性$user->is_admin = 1;// 使用静态查询方式更新，只指定要更新的字段。// 这种方式不会考虑 $user 实例的任何“脏”属性。User::whereKey($user->getKey())->update(['first_name' => 'Alex']);// 重要提示：上述静态更新操作不会自动同步内存中的 $user 实例的状态。// 如果你后续仍需使用 $user 实例，你需要手动更新其属性以反映数据库中的最新状态。$user->first_name = 'Alex'; // 手动更新实例的 first_name 属性// 此时 $user->is_admin 仍然是 1（内存中的脏值），但数据库中 is_admin 未被触及。// 如果需要 $user 实例完全反映数据库状态，可以调用 $user->refresh();// 但 refresh() 会产生额外的数据库查询，这与本教程避免额外查询的初衷相悖，// 因此通常只在确实需要完全同步时使用。
通过 User::whereKey($user->getKey())->update([‘first_name’ => ‘Alex’]); 这种方式，我们直接向数据库发送了一个 UPDATE 语句，该语句仅针对 first_name 字段进行修改，并且完全独立于 $user 模型实例在内存中的任何“脏”状态。这确保了更新的精确性。
关于 syncOriginal() 方法的说明
在某些情况下，你可能会遇到 syncOriginal() 方法。该方法的作用是将模型的所有属性重置为其“原始”状态（即从数据库加载时的状态，或上次 save()/refresh() 后的状态）。虽然 syncOriginal() 可以用于在保存前放弃模型上的所有未保存更改，但它并不能解决本教程中描述的问题。一旦模型实例的 update() 方法被调用并执行了内部的 save()，脏属性就已经被持久化到数据库。此时再调用 syncOriginal()，模型将从数据库中同步新的（包含意外更新的）状态，而非回滚。因此，syncOriginal() 不适用于在 update() 之后解决此问题。
总结与最佳实践
理解 Eloquent update() 方法在模型实例和静态查询上下文中的不同行为至关重要。
使用 $model->update(array $attributes)： 当你希望将模型实例上所有当前“脏”的属性（包括传入数组中的属性）一同保存到数据库时，使用此方法。它本质上是 $model->fill($attributes)->save() 的快捷方式。使用 Model::where()->update(array $attributes)： 当你需要精确地更新数据库中的特定列，并且不希望受到内存中任何模型实例“脏”状态的影响时，应采用此静态查询方式。这种方法会直接执行一个 UPDATE SQL 查询。请记住，使用此方法后，如果你的应用程序继续使用相关的模型实例，你需要手动更新该实例的属性以使其与数据库状态保持一致。
掌握这些区分有助于你更精确地控制数据持久化过程，从而避免在 Eloquent 应用程序中出现意外的副作用。
以上就是深入理解 Eloquent update()：如何避免意外的“脏”属性更新的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1266973.html
微信扫一扫 
支付宝扫一扫 
