Laravel Eloquent 关联筛选技巧

本文介绍了如何在 Laravel Eloquent 中基于关联表的特定条件来筛选主表数据。通过使用 whereHas 方法，可以有效地筛选出满足关联表条件的父模型，避免不必要的数据加载，从而提高查询效率。本文将提供详细的代码示例和解释，帮助开发者掌握这种高级查询技巧。

在 Laravel 中，Eloquent ORM 提供了强大的关联关系处理能力。但有时候，我们需要基于关联表的条件来筛选主表数据，而不是简单地获取所有关联数据。例如，我们希望获取所有拥有特定状态订单的用户。本文将介绍如何使用 whereHas 方法来实现这种需求。

问题描述

假设我们有两个模型：User 和 Orders，它们之间存在 belongsTo 关联关系（User 模型拥有一个 Orders 模型）。我们希望获取所有满足以下条件的用户：

• Orders 表中的 order 字段为 false。
• Orders 表中的 uploadId 字段为 null。

解决方案：使用 whereHas 方法

whereHas 方法允许我们基于关联关系的存在与否以及关联关系的条件来筛选主模型。它的基本语法如下：

Model::whereHas('relation', function (Builder $query) {
    // 在这里添加关联关系的查询条件
});

其中：

• Model 是主模型，例如 User。
• relation 是主模型中定义的关联关系名称，例如 orders。
• $query 是一个查询构建器实例，允许我们添加关联关系的查询条件。

根据上述问题描述，我们可以使用以下代码来解决：

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

代码解释

• User::whereHas('orders', ...)：这行代码表示我们要在 User 模型上进行查询，并且只返回那些存在满足特定条件的 orders 关联关系的用户。
• function ($query) { ... }：这是一个闭包函数，它接收一个 $query 对象，该对象允许我们定义 orders 关联关系的查询条件。
• $query->where('order', false)：这行代码添加了一个条件，要求 orders 表中的 order 字段必须为 false。
• $query->whereNull('uploadId')：这行代码添加了一个条件，要求 orders 表中的 uploadId 字段必须为 null。
• ->pluck('name', 'id')：这行代码从满足条件的用户中提取 name 和 id 字段，并将它们以 id => name 的形式返回。

完整示例

假设 User 模型定义了如下 orders 关联关系：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    public function orders()
    {
        return $this->hasMany(Orders::class, 'order_userId', 'id'); // Assuming Orders table has order_userId column
    }
}

并且 Orders 模型如下：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Orders extends Model
{
    //
}

那么完整的代码如下：

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;

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

        return response()->json($data);
    }
}

注意事项

• 确保 User 模型中已经定义了正确的 orders 关联关系。
• whereHas 方法只筛选主模型，不会返回关联模型的数据。如果需要同时获取关联模型的数据，可以使用 with 方法，但要注意性能问题。
• whereHas 方法还可以接受第二个参数，用于指定需要满足条件的关联关系数量，例如 whereHas('orders', ..., '>=', 2) 表示至少需要 2 个满足条件的 orders 关联关系。

总结

whereHas 方法是 Laravel Eloquent 中一个非常强大的工具，可以帮助我们基于关联表的条件来筛选主表数据。通过灵活运用 whereHas 方法，可以编写出更高效、更简洁的查询代码。希望本文能够帮助你更好地理解和使用 whereHas 方法。