当前位置：首页 > 文章列表 > 文章 > php教程 > LaravelEloquentupdate方法全解析

LaravelEloquentupdate方法全解析

2025-09-14 11:45:37 0浏览收藏

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《Laravel Eloquent update方法使用详解》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

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

本文旨在解决Laravel开发中常见的“非静态方法不能静态调用”错误，特别是针对Eloquent模型update()方法的使用。我们将深入探讨update()方法在批量更新和单个模型更新场景下的正确用法，包括如何结合查询构建器、fill()与save()，以及forceFill()，并提供相应的代码示例和注意事项，帮助开发者避免常见错误，提升代码健壮性。

在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应用中执行数据更新操作。

理论要掌握，实操不能落！以上关于《LaravelEloquentupdate方法全解析》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！