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

本文旨在解决laravel Eloquent中常见的Non-Static method … update() should not be called statically错误。该错误源于尝试直接在模型类上静态调用update()方法。教程将详细介绍三种正确的模型更新策略：带条件的批量更新、无条件的批量更新以及单个模型实例的更新，并提供相应的代码示例和注意事项，帮助开发者避免此问题并高效管理数据。

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

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

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

批量更新（带条件）

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

示例代码：

use appModelsYourModel; // 假设你的模型名为 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 AppModelsYourModel;  // 更新表中所有记录的某个字段 YourModel::query()     ->update([         'is_active' => false,         'last_reset_at' => now(),     ]);

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

单个模型实例更新

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

FineVoice语音克隆

免费在线语音克隆，1 分钟克隆你的声音，保留口音和所有细微差别。

48

查看详情

示例代码：

use AppModelsYourModel;  // 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 AppModelsYourModel;  $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 AppModelsYourModel;  $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应用程序中管理数据。