Eloquent 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() 方法。这种方法直接在数据库层面上执行更新操作，不涉及模型实例的“脏”属性状态。

影像之匠PixPretty

商业级AI人像后期软件，专注于人像精修，色彩调节及批量图片编辑，支持Windows、Mac多平台使用。适用于写真、婚纱、旅拍、外景等批量修图场景。

299

查看详情

$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() 方法的底层机制，能够帮助开发者更有效地控制数据持久化行为，避免潜在的意外数据修改，从而编写出更健壮、可预测的应用程序。

以上就是Eloquent update() 方法的精确控制：避免“脏`属性的意外更新的详细内容，更多请关注php中文网其它相关文章！