Laravel多对多查询：通过中间表查师生关系

本文深入解析了 Laravel 中如何进行复杂的多对多查询，重点讲解了通过中间表（如课程表）关联教师和学生，并高效检索特定教师所教授的所有学生。通过构建 Teacher、Period 和 Student 模型，并定义它们之间的 hasMany 和 belongsToMany 关系，本文详细演示了如何利用 Eloquent 的 `whereHas` 方法实现多层级关联查询。文章提供了完整的模型定义和查询代码示例，并探讨了预加载等性能优化技巧，帮助开发者构建高效且可维护的 Laravel 应用，解决实际业务场景中常见的数据库关联查询难题。掌握这些技巧，能显著提升 Laravel 项目的数据处理效率和代码可读性。

本文详细阐述如何在Laravel中处理复杂的多层级数据库关联查询。通过构建Teacher、Period和Student模型间的hasMany和belongsToMany关系，我们将演示如何利用Eloquent的whereHas方法，高效地从学生模型出发，通过中间的课程（Period）表，筛选出特定教师所关联的所有学生，并提供完整的模型定义和查询代码示例。

引言

在复杂的业务场景中，数据库表之间往往存在多层级的关联关系。例如，一个教师可能教授多门课程，而每门课程又会有多个学生。此时，如果我们需要查询某个特定教师所教授的所有学生，就涉及到跨越多个关联表的查询。Laravel的Eloquent ORM提供了强大且直观的机制来处理这类复杂查询，本文将深入探讨如何通过定义恰当的模型关系和利用whereHas方法来实现这一目标。

数据库结构与模型定义

首先，我们定义本教程所使用的数据库表结构：

• teachers 表: 存储教师信息。
  • id (主键)
  • username
  • pass
• periods 表: 存储课程信息，与教师关联。
  • id (主键)
  • teacher_id (外键，关联 teachers 表)
  • name
• students 表: 存储学生信息。
  • id (主键)
  • username
  • pass
• student_period 表: 存储学生与课程之间的多对多关系（Pivot Table）。
  • student_id (外键，关联 students 表)
  • period_id (外键，关联 periods 表)

接下来，我们需要在Laravel中为这些表定义相应的Eloquent模型，并建立它们之间的关系：

// app/Models/Teacher.php
<?php

namespace App\Models;

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

class Teacher extends Model
{
    use HasFactory;

    protected $fillable = ['username', 'pass'];

    /**
     * 获取该教师教授的所有课程。
     */
    public function periods(): HasMany
    {
        return $this->hasMany(Period::class);
    }
}

// app/Models/Period.php
<?php

namespace App\Models;

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

class Period extends Model
{
    use HasFactory;

    protected $fillable = ['teacher_id', 'name'];

    /**
     * 获取该课程所属的教师。
     */
    public function teacher(): BelongsTo
    {
        return $this->belongsTo(Teacher::class);
    }

    /**
     * 获取参与该课程的所有学生。
     */
    public function students(): BelongsToMany
    {
        return $this->belongsToMany(Student::class); // Laravel会自动查找 student_period 表
    }
}

// app/Models/Student.php
<?php

namespace App\Models;

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

class Student extends Model
{
    use HasFactory;

    protected $fillable = ['username', 'pass'];

    /**
     * 获取该学生参与的所有课程。
     */
    public function periods(): BelongsToMany
    {
        return $this->belongsToMany(Period::class); // Laravel会自动查找 student_period 表
    }
}

注意事项：

• 请确保你的模型文件位于app/Models目录下（或你自定义的命名空间）。
• Laravel的命名约定非常重要。例如，periods() 方法会自动查找periods表，teacher() 方法会自动查找teachers表，belongsToMany(Student::class) 会自动查找period_student或student_period这样的中间表。如果你的表名或外键名不符合约定，你需要手动指定。

实现多层级关联查询

我们的目标是：给定一个教师ID，查询所有与该教师关联的学生。这意味着我们需要从Student模型开始，通过periods表，再进一步关联到teachers表进行筛选。

Laravel的whereHas方法正是为这种场景设计的。它允许你根据关联模型是否存在或满足特定条件来筛选主模型。对于多层级关联，你可以使用“点”语法来指定嵌套关系。

use App\Models\Student;
use App\Models\Teacher; // 假设你需要获取某个教师的ID

// 假设我们要查询 ID 为 1 的教师所关联的所有学生
$teacherId = 1;

$students = Student::whereHas('periods', function ($periodQuery) use ($teacherId) {
    // 在 'periods' 关系上进一步筛选
    $periodQuery->whereHas('teacher', function ($teacherQuery) use ($teacherId) {
        // 在 'teacher' 关系上筛选，匹配特定的教师ID
        $teacherQuery->where('id', $teacherId);
    });
})->get();

// 或者更简洁的链式调用 (Laravel 8+ 支持)
// $students = Student::whereHas('periods.teacher', function ($teacherQuery) use ($teacherId) {
//     $teacherQuery->where('id', $teacherId);
// })->get();

// $students 现在包含了所有与 ID 为 1 的教师关联的学生集合
foreach ($students as $student) {
    echo "学生ID: " . $student->id . ", 姓名: " . $student->username . "\n";
}

代码解析：

1. Student::whereHas('periods', ...): 我们从Student模型开始查询。whereHas的第一个参数'periods'告诉Eloquent我们希望根据Student模型上的periods()关系来筛选。
2. function ($periodQuery) use ($teacherId): 这是一个回调函数，它接收一个QueryBuilder实例，该实例代表了periods表的查询。我们可以在这里添加针对periods表的条件。
3. $periodQuery->whereHas('teacher', ...): 在periods表的查询中，我们再次使用了whereHas，这次是针对Period模型上的teacher()关系。这表示我们需要进一步筛选那些与特定教师关联的课程。
4. function ($teacherQuery) use ($teacherId): 这是一个嵌套的回调函数，它接收一个QueryBuilder实例，代表了teachers表的查询。
5. $teacherQuery->where('id', $teacherId): 在这里，我们添加了最终的筛选条件，即教师的id必须等于我们指定的$teacherId。

通过这种方式，Eloquent会生成相应的SQL JOIN语句，高效地从students表出发，通过student_period表连接periods表，再通过periods表连接teachers表，最终返回符合条件的学生记录。

查询机制与性能考量

• Eloquent如何处理: whereHas方法在底层会执行子查询或JOIN操作。对于上述多层级查询，它会构建一个复杂的JOIN链，确保只有那些通过periods表最终能连接到指定teacher的学生才会被选中。

• 预加载（Eager Loading）: 上述查询只会返回Student模型实例。如果你在获取学生列表后，还需要访问每个学生所关联的课程信息或教师信息（例如，$student->periods 或 $student->periods->first()->teacher），那么为了避免N+1查询问题，你应该使用with()进行预加载：

  $studentsWithRelations = Student::whereHas('periods.teacher', function ($teacherQuery) use ($teacherId) {
      $teacherQuery->where('id', $teacherId);
  })->with('periods.teacher')->get(); // 预加载 periods 及其 teacher
  
  foreach ($studentsWithRelations as $student) {
      echo "学生ID: " . $student->id . ", 姓名: " . $student->username . "\n";
      foreach ($student->periods as $period) {
          echo "  - 课程: " . $period->name . " (教师: " . $period->teacher->username . ")\n";
      }
  }

  with('periods.teacher')会告诉Eloquent在查询学生时，也一并加载其关联的periods，以及每个period所关联的teacher，从而减少数据库查询次数，提高性能。

总结

Laravel Eloquent ORM为处理复杂的多层级数据库关系提供了优雅且强大的解决方案。通过正确定义模型之间的hasMany和belongsToMany关系，并结合whereHas方法，开发者可以轻松地实现跨多个关联表的复杂查询。理解其工作原理和善用预加载等性能优化技巧，将有助于构建高效且可维护的Laravel应用。

今天关于《Laravel多对多查询：通过中间表查师生关系》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！