本文详细阐述了laravel Eloquent中Model::update()方法不能静态调用的原因，并提供了三种正确的模型更新策略：带条件的批量更新、无条件的批量更新，以及单模型实例更新。同时，文章也涵盖了处理fillable属性的更新方式，旨在帮助开发者避免常见的模型更新错误，提升代码的健壮性。
在laravel框架中，使用eloquent orm进行数据库操作是日常开发的核心。然而，开发者在使用update()方法时，常常会遇到一个经典的错误提示：non-Static method illuminatedatabaseeloquentmodel::update() should not be called statically。这个错误明确指出，update()方法在illuminatedatabaseeloquentmodel类中被定义为一个非静态方法，这意味着它必须通过一个模型实例或者一个查询构建器实例来调用，而不能直接通过类名model::update()来调用。
理解 update() 方法的调用上下文
Model::update() 方法旨在更新一个已经存在的模型实例的数据，或者在查询构建器的上下文下，更新符合特定条件的一组记录。直接静态调用，Eloquent 无法知道你要更新的是哪条记录，或者哪个记录集合。因此，正确的做法是先定位到要更新的记录，然后在其上执行更新操作。
下面我们将详细介绍在Laravel中进行模型更新的几种正确方式。
1. 批量更新 (Mass Update)
批量更新允许你一次性更新多条符合特定条件的记录，或者更新表中的所有记录。这种方式效率较高，因为它通常只执行一次sql查询。
1.1 带条件的批量更新
当你需要更新数据库中符合特定条件的一组记录时，可以使用where()方法结合update()。
示例代码：
use appModelsYourModel; // 假设我们有一个AttributeOption模型 // 原始错误代码类似：AttributeOption::update(['sort_order' => $sortOrder++], $optionId); // 正确做法是先使用where()指定条件 // 更新ID为$optionId的AttributeOption记录的sort_order和其他字段 $optionId = 1; // 假设要更新的ID $optionInputs = ['name' => 'New Name', 'value' => 'New Value']; // 其他要更新的字段 $updatedRows = YourModel::where('id', $optionId) ->update(array_merge([ 'sort_order' => $sortOrder++, // 假设$sortOrder已定义 ], $optionInputs)); // $updatedRows 将返回受影响的行数 if ($updatedRows > 0) { echo "记录更新成功！"; } else { echo "未找到匹配记录或数据未改变。"; }
说明：where()方法用于构建查询条件，筛选出需要更新的记录。update()方法接收一个关联数组，键为数据库字段名，值为要更新的新数据。
1.2 无条件的批量更新
如果你需要更新表中所有记录的某个或某几个字段，可以使用query()方法或者直接在模型上调用update()（但更推荐query()来明确意图）。
示例代码：
use AppModelsYourModel; // 更新表中所有记录的status字段为'active' $updatedRows = YourModel::query() ->update([ 'status' => 'active', 'updated_at' => now(), // 也可以更新时间戳 ]); // $updatedRows 将返回受影响的行数 echo "共更新了 {$updatedRows} 条记录。";
说明：query()方法返回一个查询构建器实例，这样你就可以在其上调用update()而无需任何where条件。
2. 单模型实例更新 (Single Model Instance Update)
当你需要更新数据库中的某一条具体记录时，首先需要通过某种方式获取到该记录对应的模型实例，然后通过该实例来执行更新操作。
2.1 查找并更新
这是最常见的单模型更新方式，先通过主键或其他条件找到模型实例，然后调用实例的update()方法。
示例代码：
use AppModelsYourModel; // 假设要更新ID为1的记录 $model = YourModel::find(1); // 或者 YourModel::where('some_field', 'some_value')->first(); if ($model) { // 使用update()方法更新模型实例 $model->update([ 'field1' => 'value1', 'field2' => 'value2', ]); echo "单条记录更新成功！"; } else { echo "未找到指定记录。"; }
说明：find()方法通过主键查找记录，first()方法则返回查询结果中的第一条记录。获取到模型实例后，调用其update()方法即可。这种方式会自动处理created_at和updated_at时间戳（如果模型启用了时间戳）。
2.2 使用 fill() 和 save() (考虑 fillable 属性)
fill()方法用于将一个关联数组的数据填充到模型实例中，但它会严格遵守模型中定义的$fillable属性，只允许填充在$fillable数组中声明的字段。填充完成后，需要调用save()方法将更改持久化到数据库。
示例代码：
use AppModelsYourModel; $model = YourModel::find(1); if ($model) { $model->fill([ 'field1' => 'value1_new', 'field2' => 'value2_new', // 'field3' => 'value3_new' // 如果field3不在$fillable中，则不会被填充 ]); $model->save(); // 将更改保存到数据库 echo "使用 fill() 和 save() 更新成功！"; }
说明： 这种方法提供了更精细的控制，确保只有允许批量赋值的字段才会被更新，有效防止了批量赋值漏洞。
2.3 强制更新 forceFill() (忽略 fillable 属性)
在某些特殊场景下，你可能需要更新模型的所有字段，即使它们没有在$fillable属性中声明。这时可以使用forceFill()方法。
示例代码：
use AppModelsYourModel; $model = YourModel::find(1); if ($model) { $model->forceFill([ 'field1' => 'value1_force', 'field2' => 'value2_force', 'field3' => 'value3_force', // 即使field3不在$fillable中也会被填充 ]); $model->save(); // 将更改保存到数据库 echo "使用 forceFill() 强制更新成功！"; }
说明：forceFill()会绕过$fillable和$guarded属性的保护，强制填充所有提供的字段。使用此方法时需格外小心，确保数据来源是可信的，以避免安全风险。
注意事项
- $fillable 和 $guarded 属性：在进行批量赋值（如create(), update(), fill(), forceFill()）时，务必正确配置模型的$fillable或$guarded属性。$fillable定义了可以被批量赋值的字段白名单，而$guarded定义了不能被批量赋值的字段黑名单（通常推荐使用$fillable）。
- 模型事件：
- 单模型更新 ($model->update() 或 $model->fill()->save()) 会触发相应的模型事件（如updating, updated, saving, saved）。
- 批量更新 (YourModel::where(…)->update(…) 或 YourModel::query()->update(…)) 不会触发模型事件，也不会更新模型的updated_at时间戳（除非你在update()方法中明确指定了updated_at字段）。
- 返回值：
- 批量更新方法 (update()) 会返回受影响的行数（整数）。
- 单模型实例的update()方法会返回一个布尔值，表示更新是否成功。save()方法也会返回布尔值。
总结
Non-static method IlluminateDatabaseEloquentModel::update() should not be called statically 错误是由于对Laravel Eloquent模型更新机制的误解造成的。要正确地更新模型，你需要根据具体的业务需求选择合适的策略：对于多条记录的更新，使用带条件或无条件的批量更新；对于单条记录的更新，则需先获取模型实例，再调用其update()方法或结合fill()/forceFill()与save()方法。理解这些不同的更新方式及其背后的机制，将有助于你编写更健壮、更高效的Laravel应用程序。
评论（已关闭）
评论已关闭