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 应用程序中出现意外的副作用。
