whereHas用于基于关联模型条件过滤主模型数据,如查找包含“spam”评论的文章;orWhereHas则以“或”连接多个关联条件,两者结合可实现复杂查询逻辑。

在 Laravel 中,whereHas 和 orWhereHas 是用于基于关联模型的条件来过滤主模型数据的强大方法。它们常用于处理 Eloquent 模型之间的关系查询,比如“查找拥有符合条件的评论的文章”这类场景。
whereHas:根据关联关系添加 WHERE 条件
whereHas 用来判断某个关联是否存在,并且可以对关联模型设置查询条件。只有当关联模型满足这些条件时,主模型才会被选中。
语法:
whereHas('relation', function ($query) { ... })示例:假设有一个 Post 模型和一个 Comment 模型,它们之间是一对多关系(一篇文章有多条评论)。
你想找出所有包含“spam”评论的文章:
$posts = Post::whereHas('comments', function ($query) {
$query->where('content', 'like', '%spam%');
})->get();
这会生成一条 SQL 查询,仅返回那些关联评论中包含“spam”的文章。
orWhereHas:追加 OR 条件到关联查询
当你需要多个关联条件以“或”的方式连接时,可以使用 orWhereHas。它通常跟在 whereHas 后面,表示“或者满足另一个关联条件”。
示例:查找包含“spam”评论 或 被用户 ID 为 1 的用户评论过的文章:
$posts = Post::whereHas('comments', function ($query) {
$query->where('content', 'like', '%spam%');
})->orWhereHas('comments', function ($query) {
$query->where('user_id', 1);
})->get();
这个查询将返回满足任一条件的文章,相当于 SQL 中的 OR 关系。
嵌套与复杂条件组合
你也可以在 whereHas 内部使用更复杂的查询逻辑,比如多条件 AND 或分组。
例如:查找被用户 1 评论过且评论状态为“approved”的文章:
$posts = Post::whereHas('comments', function ($query) {
$query->where('user_id', 1)
->where('status', 'approved');
})->get();
如果想实现“用户 1 发过 approved 评论”或“有内容含 spam 的评论”,就可以结合 whereHas 和 orWhereHas:
$posts = Post::whereHas('comments', function ($query) {
$query->where('user_id', 1)->where('status', 'approved');
})->orWhereHas('comments', function ($query) {
$query->where('content', 'like', '%spam%');
})->get();
has 和 orWhereHas 的区别
注意区分:has 只检查关联是否存在(不加条件),而 whereHas 允许你指定关联模型的具体查询条件。同理,orHas 和 orWhereHas 也有类似区别。
例如:
- has('comments'):只要有评论就匹配
- whereHas('comments', fn($q) => $q->where('visible', 1)):必须有可见的评论才匹配
基本上就这些。合理使用 whereHas 和 orWhereHas,可以让你轻松实现基于关联模型的复杂筛选逻辑,写出清晰又高效的 Eloquent 查询。










