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 AppModels;  use IlluminateDatabaseEloquentFactoriesHasFactory; use IlluminateDatabaseEloquentModel; use IlluminateDatabaseEloquentRelationsHasMany;  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 AppModels;  use IlluminateDatabaseEloquentFactoriesHasFactory; use IlluminateDatabaseEloquentModel; use IlluminateDatabaseEloquentRelationsBelongsTo; use IlluminateDatabaseEloquentRelationsBelongsToMany;  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 AppModels;  use IlluminateDatabaseEloquentFactoriesHasFactory; use IlluminateDatabaseEloquentModel; use IlluminateDatabaseEloquentRelationsBelongsToMany;  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 AppModelsStudent; use AppModelsTeacher; // 假设你需要获取某个教师的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-youjiankuohaophpcnwhereHas(‘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多层级关联查询：通过中间表获取教师关联的学生的详细内容，更多请关注php中文网其它相关文章！