Laravel循环中修改数据的正确姿势-php教程-PHP中文网

foreach中直接修改对象属性无效是因为仅修改内存中的模型属性，未调用save()不会触发sql更新；批量更新应优先使用update()方法，避免n+1查询和事务问题。

laravel循环中修改数据的正确姿势

foreach 中直接修改对象属性为什么无效 Laravel 的 Eloquent 集合（`Collection`）在 `foreach` 中遍历时，拿到的是模型实例的引用副本，不是原始集合项的可变绑定。直接赋值如 `$item->name = 'new'` 确实会改掉该对象属性，但不会自动触发保存，也不会影响后续的 `save()` 调用逻辑——除非你显式调用。

常见错误现象：foreach ($users as $user) { $user->status = 1; } 执行完后数据库没变，且没有报错，容易误以为“已更新”。

这种写法只是内存中改了模型属性，没发 SQL
若集合来自 get()，它已是加载完成的 Collection，不带“延迟更新”能力
若用 cursor() 或未加载的 Builder，甚至拿不到可写的模型实例

批量更新应该用 update() 而不是循环 save() 对多条记录做同质化修改（比如全部启用、统一打标），最高效安全的方式是绕过模型层，走查询构造器的 update()：

$affected = User::where('team_id', 5)
    ->whereNull('deleted_at')
    ->update(['status' => 1, 'updated_at' => now()]);

update() 是单条 SQL，不受模型事件、访问器、强制类型转换干扰
不触发 saving/saved 等事件，适合后台脚本类场景；若需事件，再考虑其他方式
避免 N+1 查询：循环中调 $user->save() 会发出 N 条 UPDATE，还可能因事务/锁导致超时

注意：update() 不会调用模型的 setXXXAttribute()，也不校验 $fillable，所有字段按字面量写入。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

必须用模型实例逐条处理时，记得 save() 并捕获异常某些逻辑无法批量（比如每个用户要生成不同 token、调第三方 API 后才决定是否更新），就得循环操作模型：

foreach ($users as $user) {
    try {
        $user->token = Str::random(40);
        $user->last_synced_at = now();
        $user->save(); // 必须显式调用
    } catch (\Exception $e) {
        Log::error("Failed to update user {$user->id}", ['exception' => $e]);
        continue;
    }
}

每次 save() 都是一次独立事务（除非外层手动包了事务）
若需原子性，得用 DB::transaction() 包裹整个循环
记得检查 $user->isDirty()，避免无变更也发 UPDATE（虽不影响结果，但浪费日志和连接）

用 chunkById 避免内存爆炸和超时当要处理几千上万条数据时，get() 一次性加载全量模型会吃光内存，chunk() 又可能因主键不连续跳过记录。正确姿势是：

User::where('status', 0)
    ->chunkById(500, function ($users) {
        foreach ($users as $user) {
            $user->status = 1;
            $user->save();
        }
    }, 'id');