本文将深入探讨在 laravel 中如何高效地同时筛选父表和子表数据。我们将以 `post` 和 `posttag` 模型为例，详细介绍两种核心方法：直接使用 sql `join` 子句进行关联查询，以及利用 eloquent 提供的 `wherehas` 方法进行关系约束。教程将包含代码示例、两种方法的适用场景分析及优化建议，帮助开发者构建灵活且高性能的数据过滤功能。

引言：理解父子表关联筛选需求

在 Web 应用开发中，我们经常会遇到需要根据多个关联表的数据进行筛选的场景。例如，一个文章系统可能有 posts 表（父表）和 posts_tags 表（子表），其中 posts_tags 记录了文章（post）与标签（tag）的关联。现在，如果我们需要根据文章的发布年份（posts.year）以及文章所关联的特定标签（posts_tags.tag_id）来查找文章，这就要求我们同时对父表和子表进行过滤。

本教程将使用以下两个 Eloquent 模型作为示例：

• Post 模型 (App\Models\Posts\Post)：代表文章，与 posts 表对应。
• PostTag 模型 (App\Models\Posts\PostTag)：代表文章标签关联，与 posts_tags 表对应。

Post 模型中定义了 hasMany 关系，关联到 PostTag 模型：

// App\Models\Posts\Post.php
namespace App\Models\Posts;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    protected $table = "posts";

    public function PostTags()
    {
        return $this->hasMany(PostTag::class);
    }
}

PostTag 模型中定义了 belongsTo 关系，关联到 Post 模型：

// App\Models\Posts\PostTag.php
namespace App\Models\Posts;

use Illuminate\Database\Eloquent\Model;

class PostTag extends Model
{
    protected $table = "posts_tags";

    public function GetPost()
    {
        return $this->belongsTo(Post::class);
    }
}

在前端视图中，我们通过一个表单接收用户选择的年份和标签ID：

    
        
    
    
        
    
    过滤

接下来，我们将探讨如何在控制器中处理这些筛选请求。

方法一：使用 JOIN 子句进行直接关联

JOIN 子句是 SQL 中用于连接两个或多个表的强大工具。在 Laravel 的查询构建器中，我们可以通过 join() 方法来执行此操作。这种方法直接在数据库层面将父表和子表连接起来，允许您在同一个查询中对两个表的列进行筛选。

实现步骤

1. 使用 join() 方法指定要连接的子表和连接条件。连接条件通常是父表的主键与子表的外键匹配。
2. 在 where() 或 when() 子句中，对父表和子表的字段进行筛选。由于连接后可能存在同名字段，因此务必使用 表名.列名 的形式来明确指定字段所属的表，避免歧义。
3. 使用 select() 方法明确指定需要返回的列，以避免列名冲突和获取冗余数据。通常，您可能只需要父表的列，或者需要父子表的特定列。

代码示例 (MovieController.php)

join('posts_tags', 'posts.id', '=', 'posts_tags.post_id')
            ->where('posts.post_type', "movie")
            ->where('posts.is_delete', "0")
            // 根据年份筛选，如果请求中包含年份参数
            ->when($request->filled('year'), function ($query) use ($request) {
                // 注意：这里使用 'posts.year' 限定列名
                $query->where('posts.year', 'like', '%' . $request->year . '%');
            })
            // 根据标签ID筛选，如果请求中包含标签参数
            ->when($request->filled('tag'), function ($query) use ($request) {
                // 注意：这里使用 'posts_tags.tag_id' 限定列名，且通常 tag_id 是精确匹配
                $query->where('posts_tags.tag_id', $request->tag);
            })
            // 显式选择 posts 表的所有列，避免列名冲突和冗余数据
            // 如果需要子表的列，可以添加，例如 ->select('posts.*', 'posts_tags.tag_name')
            ->select('posts.*')
            // 排序时也限定列名
            ->orderBy('posts.id', 'DESC')
            ->paginate(12); // 每页显示12条数据

        // 将所有请求参数附加到分页链接中，确保翻页时筛选条件依然有效
        return $movies->appends($request->all());
    }
}

注意事项

• 外键匹配：join 条件中的外键 (posts_tags.post_id) 必须正确无误地指向父表的主键 (posts.id)。
• 列名限定：在 where、orderBy 和其他可能涉及多个表列的子句中，必须通过 表名.列名 的形式来明确指定字段所属的表，以避免 SQL 错误或意外结果。
• select() 方法：这是一个关键点。默认情况下，join 操作会返回所有连接表的列。这可能导致列名冲突（例如，如果父子表都有 created_at 字段）和数据冗余。因此，强烈建议使用 select('posts.*') 或 select('posts.id', 'posts.title', 'posts_tags.tag_id') 等方式显式选择所需的列。
• 性能：对于大型数据集和简单的关联查询，JOIN 通常在数据库层面执行效率较高，因为它能让数据库优化器更好地规划查询路径。

方法二：使用 Eloquent 的 whereHas 方法

whereHas 方法是 Eloquent 提供的一种更“面向对象”的方式，用于根据关联模型上的条件来筛选父模型。它在内部会生成一个子查询（或在某些情况下是 LEFT JOIN），以检查是否存在符合条件的关联记录。

实现步骤

1. 确保在父模型中正确定义了与子模型的 Eloquent 关系（例如 Post 模型中的 PostTags() 方法）。
2. 使用 whereHas('relationshipName', function ($query) { ... }) 来添加子模型的筛选条件。relationshipName 必须是父模型中定义的关联方法名。

代码示例 (MovieController.php)

where('post_type', "movie")
            ->where('is_delete', "0")
            // 根据年份筛选，如果请求中包含年份参数
            ->when($request->filled('year'), function ($query) use ($request) {
                // 父表字段直接使用列名
                $query->where('year', 'like', '%' . $request->year . '%');
            })
            // 根据标签ID筛选，如果请求中包含标签参数
            ->when($request->filled('tag'), function ($query) use ($request) {
                // 使用 whereHas 方法对关联模型 PostTags 进行筛选
                $query->whereHas('PostTags', function ($postTagQuery) use ($request) {
                    // 在此闭