Laravel Eloquent：使用关联查询获取指定团队的用户列表-php教程-PHP中文网

Laravel Eloquent：使用关联查询获取指定团队的用户列表

聖光之護

发布： 2025-08-08 17:22:25

原创

673人浏览过

laravel eloquent：使用关联查询获取指定团队的用户列表

本文档旨在指导开发者如何使用 Laravel Eloquent 的关联查询功能，通过 whereHas() 方法，高效地从三个关联表中（users, request_register, team）获取指定团队 ID 下的用户详细信息。我们将提供详细的代码示例和解释，帮助您理解并掌握这种强大的数据检索技巧。

简介

在 Laravel 应用开发中，经常会遇到需要从多个关联表中查询数据的场景。Eloquent ORM 提供了强大的关联关系定义和查询功能，使得我们可以方便地进行跨表查询。本教程将重点介绍如何利用 whereHas() 方法，结合 Eloquent 的关联关系，从三个关联表中筛选出特定条件下的数据。

数据库结构

假设我们有三个表：users，request_register 和 teams，它们之间的关系如下：

users: 存储用户信息，包含 user_id，name_user，contacts，request_id 等字段。
request_register: 存储用户注册请求信息，包含 request_id，user_id，team_id 等字段。
teams: 存储团队信息，包含 team_id，name_team 等字段。

我们的目标是：获取所有注册到指定 team_id 的用户的详细信息。

Eloquent 模型定义

首先，我们需要在 Laravel 中定义 Eloquent 模型，并建立它们之间的关联关系。

User 模型 (app/Models/User.php):

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasOne;

class User extends Model
{
    use HasFactory;

    protected $table = 'users';
    protected $primaryKey = 'user_id';
    public $timestamps = false;

    /**
     * Get the requestRegister associated with the User
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasOne
     */
    public function requestRegister(): HasOne
    {
        return $this->hasOne(RequestRegister::class, 'user_id', 'user_id');
    }
}

登录后复制

RequestRegister 模型 (app/Models/RequestRegister.php):

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class RequestRegister extends Model
{
    use HasFactory;

    protected $table = 'request_register';
    protected $primaryKey = 'request_id';
    public $timestamps = false;

    /**
     * Get the user that owns the RequestRegister
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class, 'user_id', 'user_id');
    }

    /**
     * Get the team that owns the RequestRegister
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function team(): BelongsTo
    {
        return $this->belongsTo(Team::class, 'team_id', 'team_id');
    }
}

登录后复制

Team 模型 (app/Models/Team.php):

酷表ChatExcel

北大团队开发的通过聊天来操作Excel表格的AI工具

查看详情

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Team extends Model
{
    use HasFactory;

    protected $table = 'teams';
    protected $primaryKey = 'team_id';
    public $timestamps = false;

    /**
     * Get all of the requestRegisters for the Team
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany
     */
    public function requestRegisters(): HasMany
    {
        return $this->hasMany(RequestRegister::class, 'team_id', 'team_id');
    }
}

登录后复制

请注意，我们假设了 user_id 和 team_id 分别是 users 和 teams 表的主键，并且 request_register 表通过 user_id 和 team_id 与 users 和 teams 表关联。另外，在User模型中，需要指定 $primaryKey 和 $timestamps 属性，否则会报错。

使用 whereHas() 进行关联查询

现在，我们可以使用 whereHas() 方法来查询指定 team_id 的用户列表。

use App\Models\User;
use Illuminate\Database\Eloquent\Builder;

$teamId = 1; // 指定的 team_id

$users = User::whereHas('requestRegister', function (Builder $query) use ($teamId) {
    $query->where('team_id', $teamId);
})->get();

// 现在，$users 包含了所有注册到 team_id 为 1 的用户的详细信息。

// 遍历结果
foreach ($users as $user) {
    echo "User ID: " . $user->user_id . ", Name: " . $user->name_user . ", Contacts: " . $user->contacts . "<br>";
}

登录后复制

代码解释：

User::whereHas('requestRegister', ...): 这行代码表示我们要查询 User 模型，并且筛选出满足特定条件的 User。whereHas('requestRegister', ...) 说明我们要基于 requestRegister 关联关系进行筛选。
function (Builder $query) use ($teamId) { ... }: 这是一个闭包函数，它接收一个 Builder 对象作为参数，允许我们进一步定义筛选条件。use ($teamId) 将外部变量 $teamId 传递到闭包函数内部。
$query->where('team_id', $teamId): 这行代码在 request_register 表中添加了一个 where 条件，只选择 team_id 等于指定 $teamId 的记录。
->get(): 执行查询，并返回一个包含所有满足条件 User 对象的集合。

总结

whereHas() 方法是 Laravel Eloquent 中一个非常强大的工具，它允许我们基于关联关系进行复杂的查询。通过合理地定义模型之间的关联关系，并结合 whereHas() 方法，我们可以轻松地从多个表中检索出所需的数据。在实际开发中，灵活运用 whereHas() 可以大大简化数据查询的逻辑，提高开发效率。

注意事项：