Laravel Eloquent 模型 update() 方法的正确使用指南

在laravel框架中，开发者在使用eloquent模型进行数据更新时，经常会遇到"non-static method illuminate\database\eloquent\model::update() should not be called statically"这样的错误提示。这通常是由于混淆了update()方法在不同上下文中的调用方式所致。update()方法在eloquent中具有两种主要的使用场景：批量更新（通过查询构建器）和单个模型实例更新。理解这两种场景的差异是正确使用该方法的关键。

理解 Laravel Eloquent 的 update() 方法

update()方法在Laravel Eloquent中扮演着核心的数据更新角色，但其行为取决于它是被静态调用（实际上是通过查询构建器）还是被实例调用。

1. 批量更新（通过查询构建器）

当update()方法被链式调用在Eloquent模型类名之后，并且前面有where()、query()等方法时，它实际上是在一个Illuminate\Database\Eloquent\Builder或Illuminate\Database\Query\Builder实例上执行的。这种调用方式用于批量更新数据库中符合特定条件或所有记录。

特点：

• 直接生成SQL语句并执行，效率较高。
• 不触发模型的creating, updated, deleted等事件。
• 不遵守模型中定义的$fillable或$guarded属性（即不进行批量赋值保护）。

示例代码：

无阶未来模型擂台/AI 应用平台

无阶未来模型擂台/AI 应用平台，一站式模型+应用平台

35

查看详情

• 批量更新带条件： 当需要更新满足特定条件的多条记录时，应首先使用where()方法定义条件，然后调用update()。例如，如果原始问题意图是更新特定id的AttributeOption记录：

  use App\Models\AttributeOption;
  
  $optionId = 123; // 假设要更新的记录ID
  $sortOrder = 1; // 假设新的排序值
  $optionInputs = ['name' => 'New Name', 'value' => 'New Value']; // 其他更新字段
  
  AttributeOption::where('id', $optionId)
      ->update(array_merge([
          'sort_order' => $sortOrder++,
      ], $optionInputs));

  登录后复制

• 批量更新无条件（更新所有记录）： 如果需要更新表中所有记录的某个字段，可以使用query()方法获取查询构建器实例，然后调用update()。

  use App\Models\AttributeOption;
  
  AttributeOption::query()
      ->update([
          'status' => 'inactive',
          'updated_at' => now(),
      ]);

  登录后复制

2. 单个模型实例更新

当update()方法被调用在一个已经从数据库中检索出来的Eloquent模型实例上时，它用于更新该特定记录的属性。

特点：

• 会触发模型的updating, updated等事件。
• 遵守模型中定义的$fillable或$guarded属性，提供批量赋值保护。
• 需要先获取模型实例。

示例代码：

• 查找并更新： 这是更新单个记录最直接的方式。首先通过find()、where()->first()等方法获取模型实例，然后在其上调用update()。

  use App\Models\AttributeOption;
  
  $optionId = 123;
  $sortOrder = 1;
  $optionInputs = ['name' => 'New Name', 'value' => 'New Value'];
  
  $attributeOption = AttributeOption::find($optionId); // 查找特定ID的记录
  
  if ($attributeOption) { // 确保模型实例存在
      $attributeOption->update(array_merge([
          'sort_order' => $sortOrder++,
      ], $optionInputs));
  }

  登录后复制

• 使用 fill() 和 save()：fill()方法用于填充模型的属性，但不会立即保存到数据库。它会遵循$fillable和$guarded的批量赋值保护规则。之后，调用save()方法将更改持久化到数据库。

  use App\Models\AttributeOption;
  
  $optionId = 123;
  $sortOrder = 1;
  $optionInputs = ['name' => 'New Name', 'value' => 'New Value'];
  
  $attributeOption = AttributeOption::find($optionId);
  
  if ($attributeOption) {
      $attributeOption->fill(array_merge([
          'sort_order' => $sortOrder++,
      ], $optionInputs))->save();
  }

  登录后复制

• 强制填充 forceFill()：forceFill()方法与fill()类似，但它会绕过$fillable和$guarded的批量赋值保护。这在某些特定场景下非常有用，但应谨慎使用，以避免潜在的安全风险。

  use App\Models\AttributeOption;
  
  $optionId = 123;
  $sortOrder = 1;
  $optionInputs = ['name' => 'New Name', 'value' => 'New Value'];
  
  $attributeOption = AttributeOption::find($optionId);
  
  if ($attributeOption) {
      $attributeOption->forceFill(array_merge([
          'sort_order' => $sortOrder++,
      ], $optionInputs))->save();
  }

  登录后复制

总结与最佳实践

• 区分场景：

  • 如果你需要更新多条记录，并且不关心模型事件和批量赋值保护，使用查询构建器的where(...)->update(...)或query()->update(...)进行批量更新。
  • 如果你需要更新单条记录，并且希望触发模型事件，同时利用$fillable进行批量赋值保护，应先获取模型实例，然后调用$model->update(...)或$model->fill(...)->save()。

• 批量赋值保护： 始终注意$fillable和$guarded属性在模型中的定义。对于从用户输入获取的数据，使用$model->update()或$model->fill()->save()是更安全的选择。仅在明确知道数据来源安全或有特殊需求时，才考虑使用forceFill()或批量更新（不经过模型）。

• 空值检查： 在对单个模型实例进行操作之前，务必检查find()或first()方法是否返回了有效的模型实例，以避免对null对象调用方法导致错误。

通过遵循这些指南，开发者可以有效地避免“非静态方法不能静态调用”的错误，并更安全、高效地在Laravel应用中执行数据更新操作。

以上就是Laravel Eloquent 模型 update() 方法的正确使用指南的详细内容，更多请关注php中文网其它相关文章！