Laravel Eloquent 模型更新策略：告别非静态方法静态调用错误

在使用laravel eloquent进行数据操作时，开发者经常会遇到“non-static method illuminate\database\eloquent\model::update() should not be called statically”的错误提示。这个错误的核心在于尝试直接在eloquent模型类（例如attributeoption::update(...)）上静态地调用update()方法，而update()方法本身是一个非静态方法，它需要在一个查询构建器实例或者一个具体的模型实例上被调用。

理解这一点至关重要：update()方法通常用于对已查询到的模型集合或单个模型实例进行操作。直接在模型类上调用而不指定任何查询条件或模型实例，Eloquent无法得知要更新哪些记录。

下面将详细介绍在Laravel中进行模型更新的几种正确策略。

批量更新（带条件）

当需要根据特定条件更新数据库中多条记录时，应首先使用查询构建器方法（如where()）来筛选目标记录，然后在其结果上调用update()方法。这种方式会直接生成一条SQL UPDATE语句并执行，效率较高。

示例代码：

use App\Models\YourModel; // 假设你的模型名为 YourModel

// 更新所有 status 为 'pending' 的记录，将其 status 改为 'approved' 且 updated_at 字段自动更新
YourModel::where('status', 'pending')
    ->update([
        'status' => 'approved',
        'processed_at' => now(), // 可以添加其他需要更新的字段
    ]);

// 示例：更新特定ID范围内的记录
YourModel::whereBetween('id', [1, 10])
    ->update([
        'value_field' => 'new_value',
    ]);

update()方法会返回受影响的行数。

批量更新（无条件）

如果需要更新数据库中某个表的所有记录，可以使用query()方法获取一个查询构建器实例，然后在其上调用update()。这等同于一个不带WHERE子句的UPDATE语句。

示例代码：

use App\Models\YourModel;

// 更新表中所有记录的某个字段
YourModel::query()
    ->update([
        'is_active' => false,
        'last_reset_at' => now(),
    ]);

注意事项： 无条件批量更新操作具有全局性，请务必谨慎使用，以免意外修改所有数据。

单个模型实例更新

当需要更新数据库中的某一条特定记录时，应首先查询并获取该记录对应的模型实例，然后在该模型实例上调用update()方法。

百灵大模型

蚂蚁集团自研的多模态AI大模型系列

177

查看详情

示例代码：

use App\Models\YourModel;

// 1. 查找单个模型实例
$model = YourModel::where('id', 123)->first(); // 使用 first() 获取单个模型实例

if ($model) {
    // 2. 在模型实例上调用 update()
    $model->update([
        'field1' => 'value1',
        'field2' => 'value2',
    ]);
    // update() 方法会返回 true（成功）或 false（失败）
} else {
    // 处理未找到模型的情况
    // 例如：throw new ModelNotFoundException();
}

// 另一种常见方式：通过 find() 方法直接查找
$anotherModel = YourModel::find(456);
if ($anotherModel) {
    $anotherModel->update([
        'status' => 'completed',
    ]);
}

这种方法会先从数据库中加载模型，然后在模型实例上执行更新操作。Eloquent会处理将更改持久化到数据库的过程。

高级单模型更新技巧：fill() 和 forceFill() 结合 save()

除了直接使用update()方法，还可以通过fill()或forceFill()方法结合save()方法来更新单个模型实例。这在需要更精细控制 mass assignment（批量赋值）时非常有用。

• fill() 方法： 遵循模型的$fillable和$guarded属性，只允许更新被定义在$fillable数组中的字段，或不被$guarded数组保护的字段。这是推荐的安全做法。

  示例代码：

  use App\Models\YourModel;
  
  $model = YourModel::find(789);
  
  if ($model) {
      $model->fill([
          'field1' => 'new_value_for_field1',
          'field2' => 'new_value_for_field2',
          // 'protected_field' => 'this_will_be_ignored_if_not_fillable',
      ])->save(); // save() 方法会返回 true 或 false
  }

  登录后复制

• forceFill() 方法： 忽略模型的$fillable和$guarded属性，强制更新所有传入的字段。这应该在确保数据来源安全的情况下使用，例如在内部管理或受信任的API调用中。

  示例代码：

  use App\Models\YourModel;
  
  $model = YourModel::find(101);
  
  if ($model) {
      $model->forceFill([
          'field1' => 'force_updated_value',
          'field2' => 'another_force_value',
          'protected_field' => 'this_will_be_updated_even_if_guarded', // 即使被 $guarded 也会被更新
      ])->save();
  }

  登录后复制

注意事项与最佳实践

1. 批量赋值保护 ($fillable / $guarded)： 在使用update()、fill()或create()等方法进行批量赋值时，务必在模型中定义$fillable或$guarded属性来防止潜在的安全漏洞。
   • $fillable：允许批量赋值的字段白名单。
   • $guarded：不允许批量赋值的字段黑名单（默认['*']表示所有字段都受保护，需手动指定$fillable）。
2. update() 的返回值：
   • 在查询构建器上调用update()（批量更新）会返回受影响的行数（整数）。
   • 在模型实例上调用update()（单个模型更新）会返回true或false，表示更新是否成功。
   • save() 方法同样返回true或false。
3. 时间戳自动更新： Eloquent模型默认会自动管理created_at和updated_at时间戳。当使用update()或save()方法时，updated_at字段会自动更新。
4. 选择合适的更新方式：
   • 当需要更新多条记录且无需先加载到内存时，使用带条件的批量更新（where()->update()）效率最高。
   • 当需要更新单条记录，且可能需要进行额外操作（如事件触发、修改器/访问器）时，先获取模型实例再调用update()或fill()->save()。
   • 在确保数据安全的前提下，forceFill()->save()提供了最大的灵活性。

通过理解和正确应用上述更新策略，可以有效避免“非静态方法静态调用”的错误，并更安全、高效地在Laravel应用程序中管理数据。

以上就是Laravel Eloquent 模型更新策略：告别非静态方法静态调用错误的详细内容，更多请关注php中文网其它相关文章！