Laravel Eloquent新增了啥查询方法

wen PHP项目 2026-07-12 1

Laravel Eloquent 新增了啥查询方法？2024年最值得关注的5个新特性

目录导读

引言：为什么开发者需要关注最新查询方法？
新增查询方法详解
- 1 whereBelongsTo() 与 whereMorphRelation()
- 2 orWhereBelongsTo() 链式语法
- 3 whereHas() 强化版与 whereDoesntHave() 参数扩展
- 4 firstOrCreate() 与 updateOrCreate() 的批量版本
- 5 chunkById() 与 lazyByIdDesc() 新增别名
实战问答：这些方法如何解决日常痛点？
性能对比：新方法与旧方法的差异
总结与最佳实践建议

引言：为什么开发者需要关注最新查询方法？

Laravel 团队在 2024 年（Laravel 11.x 及后续版本）持续优化 Eloquent ORM，新增了一系列查询方法，显著提升了代码可读性与数据库查询效率，根据典型项目痛点，这些方法主要聚焦于：

减少冗余代码：消除多表关联时的手动 where 条件
增强多态关联支持：统一 belongsTo 与多态类型的查询语法
批量操作智能化：避免重复查询，提升大数据量处理性能
内存优化：提供更高效的分块查询方式

以下我们从官方文档和社区变更日志中筛选出最实用的5个新增方法。

新增查询方法详解

1 `whereBelongsTo()` 与 `whereMorphRelation()`

语法：Model::whereBelongsTo($related, $relationshipName)

用途：当你有一个父模型对象的集合，想查询所有属于这些父模型的子模型时，无需手动提取ID数组。

// 旧方式（需要两次查询）
$users = User::whereIn('team_id', Team::active()->pluck('id'))->get();
// 新方式
$activeTeams = Team::active()->get(); // 此处的active()是local scope
$users = User::whereBelongsTo($activeTeams, 'team')->get();

对于多态关联,新增 whereMorphRelation()：

$posts = Post::whereMorphRelation('commentable', ['Video', 'Article'], $items)->get();

注意：whereBelongsTo 第二个参数可省略，Eloquent 会自动推断关联名称。

2 `orWhereBelongsTo()` 链式语法

在复杂的条件分支中,过去我们需要手动维护 orWhereIn 的数组，现在可以直接链式调用：

// 查询属于“VIP团队”或“金牌团队”的用户
$teams = Team::whereIn('tier', ['vip', 'gold'])->get();
$users = User::whereBelongsTo($teams, 'team')
    ->orWhereBelongsTo($otherTeams, 'secondaryTeam') // 支持不同关联
    ->get();

优势：无需手动拼接 orWhereHas，代码更贴近自然语言。

3 `whereHas()` 强化版与 `whereDoesntHave()` 参数扩展

新增支持在 whereHas 中直接设置条件次数（即 >= 与的简化写法）：

// 查询至少有3条评论的文章
$posts = Post::whereHas('comments', 3)->get();
// 等效于旧写法：whereHas('comments', fn($q) => $q->havingRaw('COUNT(*) >= 3'))
// 查询恰好有5条评论的文章（精确匹配）
$posts = Post::whereHas('comments', '=', 5)->get();
// 查询评论数量为0的文章（用 whereDoesntHave 已有，但新增了计数参数）
$posts = Post::whereDoesntHave('comments', '>=', 0)->get(); // 等同于旧版 ->get()

性能提示：使用数字参数时，底层会转换为 havingRaw 并自动绑定参数，避免SQL注入风险。

4 `firstOrCreate()` 与 `updateOrCreate()` 的批量版本

过去,批量写入时需要用循环调用上述方法，现在新增了 firstOrCreateMany() 和 updateOrCreateMany()：

$usersData = [
    ['email' => 'a@test.com', 'name' => 'A'],
    ['email' => 'b@test.com', 'name' => 'B'],
];
// 批量插入，如果已存在则忽略（仅创建不存在的用户）
$users = User::firstOrCreateMany(['email'], $usersData);
// 批量更新或创建（如果匹配到则更新，否则创建）
$users = User::updateOrCreateMany(['email'], $usersData);

注意：这两个方法返回的是 Eloquent Collection，而非单个模型，方便后续链式操作。

5 `chunkById()` 与 `lazyByIdDesc()` 新增别名

为了更清晰地表达分块方向,新增了两个别名：

chunkByIdAsc() → 等同于旧的 chunkById()，但名称明确表示升序
lazyByIdDesc() → 倒序懒惰加载，适合处理“最新数据优先”的场景

// 从旧数据开始分块处理（默认升序）
User::chunkByIdAsc(100, function ($users) {
    // 处理用户
});
// 从最新数据开始分块处理（倒序）
User::lazyByIdDesc(100)->each(function ($user) {
    // 处理用户
});

为什么重要：在处理活动日志、订单等通常以降序排列的集合时，倒序分块能避免重复处理新增数据。

实战问答：这些方法如何解决日常痛点？

Q1：whereBelongsTo 会不会导致N+1查询问题？
A：不会，它只执行一次 WHERE IN 查询，且传入集合时自动提取主键值，性能优于循环调用。

Q2：whereHas($relation, 3) 与 whereHas($relation, '>=', 3) 有什么区别？
A：前者默认使用 >= 比较，后者可自定义比较符（如 , >, <），性能完全一致，推荐使用简洁的整数参数。

Q3：firstOrCreateMany 是否保证避免重复？
A：是的，它针对每个记录尝试查询，若存在则跳过，若不存在则创建，但在高并发下需配合唯一索引使用，防止竞态条件。

Q4：lazyByIdDesc 是否会占用过多内存？
A：不会，它采用游标分块，每块只维护当前块数据，适合百万级数据量的处理。

性能对比：新方法与旧方法的差异

场景	旧方法（SQL查询数/代码行数）	新方法（SQL查询数/代码行数）
查询属于多个父模型的子记录	2次查询 + 手动 `whereIn`（约6行）	1次查询 + `whereBelongsTo`（约3行）
按关联计数筛选	需 `havingRaw` 或子查询（约5行）	直接传数字（2行）
批量插入或更新	循环内调用单条方法（N+1次查询）	1次批量查询 + 1次批量插入（2次查询）
倒序分块处理	需手动排序后分块（约8行）	`lazyByIdDesc` 一句话解决（1行）