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

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

聖光之護

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

原创

369人浏览过

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

本文档详细介绍了如何在 Laravel 8 中使用 Eloquent ORM，通过关联查询 users、request_register 和 team 三个表，高效地获取属于特定团队的用户信息。我们将深入探讨 whereHas() 方法的使用，并提供清晰的代码示例和注意事项，帮助开发者掌握 Laravel 中多表关联查询的技巧。

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

在 Laravel 开发中，经常需要从多个关联表中检索数据。本文将演示如何使用 Eloquent ORM，通过关联 users、request_register 和 team 三个表，获取属于特定团队的用户列表。

假设我们有以下三个表结构：

users：包含用户信息，字段包括 user_id、name_user、contacts 和 request_id。
request_register：记录用户注册请求，字段包括 request_id、user_id 和 team_id。
team：包含团队信息，字段包括 team_id 和 name_team。

我们的目标是获取属于特定 team_id 的所有用户信息，例如，获取 team_id 为 1 的所有用户。

1. 定义 Eloquent 模型关系

首先，我们需要在 Eloquent 模型中定义表之间的关系。

在 User 模型中，定义与 RequestRegister 模型的关系：

// app/Models/User.php

namespace App\Models;

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

class User extends Model
{
    protected $table = 'users';
    protected $primaryKey = 'user_id';
    public $timestamps = false;

    /**
     * Get the request registers for the user.
     */
    public function request_register(): HasMany
    {
        return $this->hasMany(RequestRegister::class, 'user_id', 'user_id');
    }
}

登录后复制

在 RequestRegister 模型中，定义与 Team 模型的关系：

// app/Models/RequestRegister.php

namespace App\Models;

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

class RequestRegister extends Model
{
    protected $table = 'request_register';
    protected $primaryKey = 'request_id';
    public $timestamps = false;

    /**
     * Get the team that owns the request register.
     */
    public function team(): BelongsTo
    {
        return $this->belongsTo(Team::class, 'team_id', 'team_id');
    }

    /**
     * Get the user that owns the request register.
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class, 'user_id', 'user_id');
    }
}

登录后复制

在 Team 模型中，定义与 RequestRegister 模型的关系：

// app/Models/Team.php

namespace App\Models;

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

class Team extends Model
{
    protected $table = 'team';
    protected $primaryKey = 'team_id';
    public $timestamps = false;

    /**
     * Get the request registers for the team.
     */
    public function request_register(): HasMany
    {
        return $this->hasMany(RequestRegister::class, 'team_id', 'team_id');
    }
}

登录后复制

注意: 请根据你的实际表名和字段名修改模型中的 table 和 primaryKey 属性，以及关系定义中的外键和本地键。确保模型文件放置在 app/Models 目录下。

酷表ChatExcel

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

查看详情

2. 使用 whereHas() 方法进行查询

现在，我们可以使用 whereHas() 方法来查询属于特定团队的用户。

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

$teamId = 1; // 要查询的 team_id

$users = User::whereHas('request_register', 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 . "<br>";
}

登录后复制

这段代码首先定义了要查询的 teamId。然后，使用 User::whereHas('request_register', ...) 方法，表示我们要查询与 request_register 关系相关的用户。

whereHas() 方法的第二个参数是一个闭包，它接收一个 Builder 实例作为参数。在这个闭包中，我们使用 $query->where('team_id', $teamId) 来限制 request_register 表中的 team_id 必须等于 $teamId。

最后，使用 ->get() 方法获取所有符合条件的用户。

3. 获取更多关联信息

如果需要获取团队名称等更多信息，可以通过 eager loading 来优化查询。

$teamId = 1;

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

foreach ($users as $user) {
    echo "User ID: " . $user->user_id . ", Name: " . $user->name_user . ", Team Name: " . $user->request_register->first()->team->name_team . "<br>";
}

登录后复制

这里，我们使用了 ->with('request_register.team') 方法来 eager load request_register 和 team 关系。这样，在循环遍历用户时，可以直接通过 $user->request_register->first()->team->name_team 获取团队名称，而无需额外的数据库查询。注意，这里使用了first() 方法，因为一个用户可以有多个注册请求，但我们只需要获取其中一个来获取团队信息。