在使用 laravel 进行项目开发时，经常会遇到需要批量更新数据库记录的场景。例如，用户修改了多个商品的价格，或者需要更新多个用户的状态。如果每个记录的更新值都不同，传统的 Eloquent 模型更新方式可能会导致大量的数据库查询，严重影响性能。
iksaku/laravel-mass-update
库应运而生，它允许你使用单个查询更新多个 Laravel 模型记录，每个记录可以有不同的值，从而大大提高了数据库操作的效率。
安装
使用 composer 安装非常简单：
<pre class="brush:php;toolbar:false;">composer require iksaku/laravel-mass-update
使用方法
- 引入 Trait
在你的 Eloquent 模型中，引入
IksakuLaravelMassUpdateMassUpdatable
trait：
<pre class="brush:php;toolbar:false;">use IlluminateDatabaseEloquentModel; use IksakuLaravelMassUpdateMassUpdatable; class User extends Model { use MassUpdatable; // ... }
- 简单用例：更新多个记录的值
假设你有一个
users
表，现在需要更新多个用户的姓名：
<pre class="brush:php;toolbar:false;">User::massUpdate( values: [ ['id' => 1, 'name' => 'Jorge González'], ['id' => 2, 'name' => 'Gladys Martínez'], ] );
这将使用单个 sql 查询更新
id
为 1 和 2 的用户的姓名。
- 使用其他字段作为唯一标识
默认情况下，
massUpdate
使用模型的主键作为唯一标识。如果你想使用其他字段，例如
username
，可以这样：
<pre class="brush:php;toolbar:false;">User::massUpdate( values: [ ['username' => 'iksaku', 'name' => 'Jorge González'], ['username' => 'gm_mtz', 'name' => 'Gladys Martínez'], ], uniqueBy: 'username' );
- 更新多个 Eloquent 模型
如果你已经获取了多个 Eloquent 模型实例，可以直接将它们传递给
massUpdate
：
<pre class="brush:php;toolbar:false;">$jorge = User::find(1); $gladys = User::find(2); $jorge->name = 'Jorge González'; $gladys->name = 'Gladys Martínez'; User::massUpdate( values: [$jorge, $gladys] );
- 复杂用例：使用多个索引来区分记录
假设你有一个
expenses
表，需要根据
year
和
quarter
来更新记录：
<pre class="brush:php;toolbar:false;">Expense::massUpdate( values: [ ['year' => 2020, 'quarter' => 'Q1', 'total_expenses' => 431.35], ['year' => 2021, 'quarter' => 'Q1', 'total_expenses' => 416.70], ], uniqueBy: ['year', 'quarter'] );
注意：
-
uniqueBy
中指定的字段必须包含在
values
数组中。
- 不能更新
uniqueBy
中指定的字段的值。
- 高级用例：与其他查询语句链式调用
你可以将
massUpdate
与其他查询语句链式调用，例如
where
：
<pre class="brush:php;toolbar:false;">TodoItem::query() ->where('user_id', auth()->id()) ->massUpdate( values: collect($request->input('item_order')) ->mapWithKeys( fn ($id, int $position) => ['id' => $id, 'order' => $position] ) );
优势
- 性能提升： 使用单个 SQL 查询更新多个记录，减少了数据库交互次数，提高了性能。
- 代码简洁： 简化了批量更新的代码，提高了可读性和可维护性。
- 灵活： 支持多种使用场景，包括更新普通数组、Eloquent 模型和使用多个字段作为唯一标识。
实际应用效果
在我的项目中，使用
iksaku/laravel-mass-update
后，批量更新操作的性能提升了 50% 以上，极大地改善了用户体验。
总而言之，
iksaku/laravel-mass-update
是一个非常实用的 Laravel 扩展包，可以帮助你高效地批量更新数据库记录，优化数据库操作，提升应用性能。如果你在 Laravel 项目中需要进行批量更新操作，不妨尝试一下这个库。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
喜欢就支持一下吧
相关推荐
