批量更新Laravel模型：iksaku/laravel-mass-update助你优化数据库操作-composer-PHP中文网

批量更新Laravel模型：iksaku/laravel-mass-update助你优化数据库操作

WBOY

发布： 2025-08-24 11:42:17

原创

381人浏览过

在使用 Laravel 进行项目开发时，经常会遇到需要批量更新数据库记录的场景。例如，用户修改了多个商品的价格，或者需要更新多个用户的状态。如果每个记录的更新值都不同，传统的 Eloquent 模型更新方式可能会导致大量的数据库查询，严重影响性能。

composer在线学习地址：学习地址

iksaku/laravel-mass-update

登录后复制

库应运而生，它允许你使用单个查询更新多个 Laravel 模型记录，每个记录可以有不同的值，从而大大提高了数据库操作的效率。

安装

使用 Composer 安装非常简单：

<pre class="brush:php;toolbar:false;">composer require iksaku/laravel-mass-update

登录后复制

使用方法

引入 Trait

在你的 Eloquent 模型中，引入

Iksaku\Laravel\MassUpdate\MassUpdatable

登录后复制

trait：

<pre class="brush:php;toolbar:false;">use Illuminate\Database\Eloquent\Model;
use Iksaku\Laravel\MassUpdate\MassUpdatable;

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

登录后复制

，可以这样：

豆包AI编程

豆包推出的AI编程助手

1697

查看详情

<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]
            )
    );

登录后复制

优势