在使用 Eloquent 模型实例的 update() 方法时，除了传入的指定字段外，模型上预先修改但未保存的“脏”属性也可能被一并更新。这是因为 update() 内部会调用 fill() 和 save() 方法，导致模型实例的所有修改都被持久化。为实现只更新指定字段并忽略模型实例上的“脏”属性，应采用静态的 Model::where()->update() 查询方式直接操作数据库，并在需要时手动同步模型实例状态。
Eloquent update() 方法的行为解析
在使用 Eloquent 进行数据更新时，开发者可能会遇到一个常见的误解：当通过模型实例调用 update() 方法并传入一个属性数组时，如果该模型实例在此之前已经有其他属性被修改（即“脏”属性），这些“脏”属性也会被一并保存到数据库中。
考虑以下代码示例：
$user = User::find(1); // 从数据库加载用户ID为1的记录 $user->is_admin = 1; // 修改了is_admin属性，但尚未保存 $user->update(['first_name' => 'Alex']); // 尝试只更新first_name
在此示例中，我们期望只有 first_name 字段被更新为 ‘Alex’。然而，实际执行后，is_admin 字段也会被更新为 1。
这种行为的根本原因在于 Eloquent 的 update() 方法的内部实现。当你通过模型实例 $model->update([…]) 调用时，该方法实际上会首先调用 fill() 方法来填充传入的属性，然后在其内部执行 $this->save() 方法。save() 方法会检查模型实例上所有被修改过的属性（即“脏”属性），并将它们一并持久化到数据库。因此，is_admin 属性虽然没有在 update() 方法的参数数组中，但因为它在调用 update() 之前已经被修改，所以它也被视为“脏”属性并被保存。
Eloquent 模型中 update() 方法的简化定义如下：
public function update(array $attributes = [], array $options = [])
{
if (! $this->exists) {
return false;
}
// 填充传入的属性，然后保存整个模型实例
return $this->fill($attributes)->save($options);
}
从上述定义可以看出，update() 方法的核心是调用 save()。只要模型实例上存在任何被修改的属性，save() 都会尝试将它们写入数据库。
精确更新策略：使用静态 where()->update()
为了实现只更新指定字段，并完全忽略模型实例上其他未保存的“脏”属性，最直接且推荐的方法是使用 Eloquent 的静态 where()->update() 方法。这种方法直接在数据库层面上执行更新操作，不涉及模型实例的“脏”属性状态。
$user = User::find(1); // 从数据库加载用户ID为1的记录 $user->is_admin = 1; // 仍然修改了is_admin属性，但这次它不会被意外保存 // 使用静态方法直接更新数据库，只更新first_name User::whereKey($user->getKey())->update(['first_name' => 'Alex']);
通过 User::whereKey($user->getKey())->update([‘first_name’ => ‘Alex’]);，我们直接向数据库发送了一个更新查询，只指定了 first_name 字段进行更新。此时，$user 实例上的 is_admin 属性虽然被修改了，但由于这次更新操作是独立的数据库查询，它不会受到 $user 实例内部状态的影响。
同步模型实例状态
需要注意的是，使用静态 where()->update() 方法更新数据库后，原始的 $user 模型实例并不会自动反映这些变化。如果后续代码需要使用到更新后的 $user 实例，你需要手动同步其状态。
$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');
或者，如果你想确保模型实例完全同步数据库的最新状态，可以使用 refresh() 方法（这会触发一次额外的数据库查询）：
$user = User::find(1); $user->is_admin = 1; User::whereKey($user->getKey())->update(['first_name' => 'Alex']); // 从数据库重新加载模型实例，确保其状态与数据库一致 $user->refresh();
关于 syncOriginal() 方法的说明
Eloquent 提供了 syncOriginal() 方法，用于将模型的当前属性值同步为原始属性值， effectively marking all current changes as “saved”. 它的作用是重置模型的“脏”状态。
$user = User::find(1); $user->is_admin = 1; $user->first_name = 'John'; // 此时 is_admin 和 first_name 都是脏属性 $user->syncOriginal(); // 现在 is_admin 和 first_name 都不再是脏属性了 // 如果此时调用 $user->save(); 将不会有任何更新操作，因为模型不再有脏属性
然而，syncOriginal() 方法并不能解决本文开头提出的问题。因为它是在 update() 之前或 之后操作模型状态的方法。一旦 update() 方法被调用，它就已经执行了 save() 操作，将所有“脏”属性持久化到数据库中。syncOriginal() 无法撤销已经发生的数据库写入。因此，它不能用于防止 update() 方法意外保存其他“脏”属性。
总结与最佳实践
- 使用 $model->update(array $attributes)： 当你希望将模型实例上所有已修改的属性（包括传入 update() 方法的属性和之前修改的“脏”属性）一并保存到数据库时，可以使用此方法。这适用于你确切知道并希望保存模型实例所有当前状态的场景。
- 使用 Model::where()->update(array $attributes)： 当你只需要更新数据库中特定记录的指定字段，并且不希望受到模型实例上其他“脏”属性的影响时，应采用这种静态方法。这提供了更精确的控制，特别是在处理并发更新或避免意外副作用时非常有用。
- 状态同步： 使用静态 where()->update() 后，如果你的应用程序逻辑需要使用到更新后的模型实例，请务必手动同步其属性，或使用 refresh() 方法重新加载。
理解 Eloquent update() 方法的底层机制，能够帮助开发者更有效地控制数据持久化行为，避免潜在的意外数据修改，从而编写出更健壮、可预测的应用程序。
暂无评论内容