Laravel Eloquent：基于关联关系进行条件查询-php教程-PHP中文网

Laravel Eloquent：基于关联关系进行条件查询

心靈之曲

发布： 2025-07-18 17:32:01

原创

383人浏览过

laravel eloquent：基于关联关系进行条件查询

本文档旨在解决 Laravel Eloquent 中基于关联关系进行条件查询时，如何准确获取符合特定条件的 User 数据。我们将探讨如何使用 whereHas 方法，结合关联关系定义，实现高效且精确的数据筛选，避免返回不符合条件的数据。通过本文的学习，你将能够熟练掌握 Laravel Eloquent 关联查询的技巧，提升数据检索的效率和准确性。

在 Laravel 中，Eloquent ORM 提供了强大的关联关系管理功能，允许我们轻松地在不同的模型之间建立联系。然而，在实际应用中，我们经常需要基于关联关系进行条件查询，即只获取那些满足特定关联条件的数据。本文将详细介绍如何使用 Laravel Eloquent 的 whereHas 方法来实现这一目标，并避免一些常见的错误。

理解 whereHas 方法

whereHas 方法允许你指定一个闭包函数，该函数将在关联关系的查询中执行。只有当关联关系满足闭包函数中的条件时，父模型才会被包含在结果集中。这与直接在 with 方法中使用 where 子句不同，后者只是限制了关联关系的返回结果，而不会过滤父模型。

示例：基于 Orders 表筛选 User 数据

假设我们有两个模型：User 和 Orders，它们之间存在 belongsTo 关系。我们想要获取所有在 Orders 表中存在 order 字段为 false 且 uploadId 字段为 null 的关联记录的 User 的 id 和 name。

以下是 User 模型中 orders 关联关系的定义：

// User Model
public function orders()
{
    return $this->belongsTo(Orders::class, 'order_userId', 'id');
}

登录后复制

正确的查询方式是使用 whereHas 方法：

硅基智能

基于Web3.0的元宇宙，去中心化的互联网，高质量、沉浸式元宇宙直播平台，用数字化重新定义直播

查看详情

$data = User::whereHas('orders', function ($query) {
    $query->where('order', false);
    $query->whereNull('uploadId');
})->pluck('name', 'id');

登录后复制

代码解释：

User::whereHas('orders', ...)：这部分代码表示我们要在 User 模型上进行查询，并且只返回那些存在满足特定条件的 orders 关联关系的 User。
function ($query) { ... }：这是一个闭包函数，它接收一个 $query 对象作为参数，该对象代表 Orders 模型的查询构建器。
$query->where('order', false);：这行代码添加了一个条件，要求 Orders 表中的 order 字段必须为 false。
$query->whereNull('uploadId');：这行代码添加了一个条件，要求 Orders 表中的 uploadId 字段必须为 null。
->pluck('name', 'id');：获取name和id列并返回键值对形式的数组。

错误示例及分析

以下是一个常见的错误示例：

$data = User::with(['orders'=>function ($query){
    $query->where('order', false);
    $query->whereNull('uploadId');
}])->pluck('name', 'id');

登录后复制

这段代码的错误在于它使用了 with 方法，而不是 whereHas 方法。with 方法只是在查询 User 模型时，顺便加载了 orders 关联关系，并使用 where 子句限制了 orders 关联关系的返回结果。但是，它不会过滤 User 模型本身，即使某个 User 没有满足条件的 orders 关联关系，它仍然会被包含在结果集中，只是 orders 字段的值为 null。

注意事项和总结