在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属性（即不进行批量赋值保护）。
示例代码：
-
批量更新带条件： 当需要更新满足特定条件的多条记录时，应首先使用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应用中执行数据更新操作。
