本文旨在解决Laravel开发中常见的“非静态方法Illuminate/Database/Eloquent/Model::update()不能被静态调用”错误。我们将详细讲解如何正确使用Eloquent的update方法进行批量数据更新和单条模型更新，包括带条件和不带条件的更新，以及利用fill()、save()和forceFill()进行模型实例更新的最佳实践，确保代码的健壮性和安全性。
在使用laravel eloquent进行数据更新时，开发者常会遇到non-static method illuminate/database/eloquent/model::update() should not be called statically这样的错误提示。这通常是因为尝试直接在model类上静态调用update()方法，而update()方法在多数情况下需要通过查询构建器实例或已获取的模型实例来调用。理解其正确的使用场景是避免此错误的关键。
1. 批量更新（Mass Update）
当需要一次性更新多条符合特定条件或所有记录时，应通过Eloquent的查询构建器（Query Builder）来调用update()方法。这种方式会直接在数据库层面执行SQL更新语句，效率较高，且不触发模型的事件（如updating, updated等）。
1.1 带有条件的批量更新
这是最常见的批量更新场景，通过where()方法指定更新条件。
<?php
namespace App/Http/Controllers;
use App/Models/AttributeOption; // 假设您的模型是 AttributeOption
use Illuminate/Http/Request;
class AttributeOptionController extends Controller
{
public function updateOptions(Request $request)
{
$optionId = $request->input('option_id'); // 假设通过请求获取ID
$sortOrder = $request->input('sort_order', 1); // 假设获取排序值
$optionInputs = $request->only(['name', 'value']); // 假设其他更新字段
// 示例：更新指定ID的AttributeOption，并设置新的排序和其他属性
AttributeOption::where('id', $optionId)
->update(array_merge([
'sort_order' => $sortOrder,
], $optionInputs));
return response()->json(['message' => '选项已成功更新。']);
}
}
在上述示例中，AttributeOption::where(‘id’, $optionId)返回一个查询构建器实例，然后在此实例上调用update()方法，传入一个包含待更新字段及其值的关联数组。
1.2 不带条件的批量更新
如果需要更新表中所有记录的某个字段，可以通过query()方法获取一个查询构建器实例，然后在其上调用update()。
<?php
use App/Models/Product; // 假设您的模型是 Product
// 示例：将所有产品的状态设置为“草稿”
Product::query()->update([
'status' => 'draft',
'updated_at' => now(), // 也可以手动更新时间戳
]);
Product::query()等同于Product::newQuery()，它返回一个新的查询构建器实例，可以用于构建查询或执行批量操作。
2. 单条模型更新（Single Model Update）
当需要更新数据库中的单条记录时，通常会先检索该记录，然后对模型实例进行操作。这种方式会触发模型事件，更符合面向对象的编程范式。
2.1 先获取再更新
首先通过主键或其他条件获取一个模型实例，然后调用该实例的update()方法。
<?php
use App/Models/User; // 假设您的模型是 User
// 示例：更新ID为1的用户信息
$user = User::find(1); // 或 User::where('email', 'test@example.com')->first();
if ($user) {
$user->update([
'name' => 'Jane Doe',
'email' => 'jane.doe@example.com',
]);
// 此时，$user 实例已经被更新，并已保存到数据库
}
此处的$user-youjiankuohaophpcnupdate([…])方法会根据模型实例的$fillable属性（或$guarded属性）来决定哪些字段可以被批量赋值。
2.2 使用 fill() 和 save()
为了更精细地控制字段填充，特别是当您希望明确哪些字段可以被赋值时，可以使用fill()方法结合save()方法。fill()方法会根据模型的$fillable属性（白名单）或$guarded属性（黑名单）来安全地填充模型属性，而save()方法则负责将这些更改持久化到数据库。
<?php
use App/Models/User;
$user = User::find(1);
if ($user) {
// 假设 User 模型定义了 $fillable = ['name', 'email'];
$user->fill([
'name' => 'John Smith',
'email' => 'john.smith@example.com',
'password' => 'new_password', // 如果 password 不在 $fillable 中，此字段将被忽略
]);
$user->save(); // 将更改保存到数据库
}
注意事项： fill()方法会严格遵守模型定义的$fillable或$guarded规则，以防止批量赋值漏洞（Mass Assignment Vulnerability）。
2.3 强制填充 forceFill()
在某些特殊情况下，您可能需要绕过$fillable或$guarded的限制，强制填充所有提供的属性。这时可以使用forceFill()方法。
<?php
use App/Models/User;
$user = User::find(1);
if ($user) {
// 即使 'password' 不在 $fillable 中，也会被强制填充
$user->forceFill([
'name' => 'Alice',
'email' => 'alice@example.com',
'password' => bcrypt('new_secure_password'), // 通常密码需要加密
'is_admin' => true,
]);
$user->save(); // 将更改保存到数据库
}
重要提示： forceFill()方法应谨慎使用，因为它会绕过模型的安全机制。通常只在信任的数据源或内部管理任务中使用。
总结
Model::update()方法不应被静态调用，除非它是像updateOrCreate()这样的特定静态方法。正确的做法是：
- 对于批量更新：通过YourModel::where(…)->update([…])或YourModel::query()->update([…])在查询构建器实例上调用update()。
- 对于单条模型更新：先获取模型实例（例如$model = YourModel::find(1);），然后调用该实例的$model->update([…])。或者使用$model->fill([…])->save()（遵循$fillable）或$model->forceFill([…])->save()（强制填充）。
遵循这些最佳实践，可以有效避免常见的更新错误，并确保Laravel应用程序的数据操作既高效又安全。
以上就是Laravel Eloquent 模型更新方法详解：避免非静态调用错误的详细内容，更多请关注php中文网其它相关文章！