Laravel Eloquent 关联查询：同时过滤父子表数据

本文旨在指导如何在 Laravel 应用中，利用 Eloquent ORM 同时对父表和子表数据进行过滤。通过示例代码，我们将探讨 `join` 和 `whereHas` 两种核心方法，以实现基于父表字段（如年份）和子表关联字段（如标签ID）的复合搜索逻辑，确保数据查询的准确性和效率。

在 Laravel 应用开发中，我们经常会遇到需要根据多个条件筛选数据的情况，而这些条件可能分布在不同的关联表中。例如，在一个电影管理系统中，我们可能需要同时根据电影的年份（存储在主表 posts 中）和其关联的标签（存储在子表 posts_tags 中）来搜索电影。本教程将详细介绍如何使用 Laravel Eloquent 提供的 join 和 whereHas 方法来实现这一复杂的过滤需求。

理解问题场景：父子表关联过滤

假设我们有两个模型：Post（父表，代表电影）和 PostTag（子表，代表电影标签）。 Post 表包含电影的基本信息，如 year（年份）。 PostTag 表存储电影与标签的关联，包含 post_id（外键关联到 posts 表的 id）和 tag_id（标签ID）。

我们的目标是构建一个搜索功能，允许用户同时选择年份和标签来筛选电影。

模型定义与关联关系

为了在 Eloquent 中进行关联查询，首先需要正确定义模型及其关系。

Post 模型 (app/Models/Posts/Post.php)

hasMany(PostTag::class);
    }
}

PostTag 模型 (app/Models/Posts/PostTag.php)

belongsTo(Post::class);
    }
}

方法一：使用 join 语句进行关联过滤

join 语句允许我们直接将两个或多个表连接起来，然后像操作单个表一样进行过滤。这种方法在需要从关联表中选择列，或者当 whereHas 无法满足复杂的多级关联查询时非常有用。

示例代码：

use App\Models\Posts\Post;
use Illuminate\Http\Request;

// ... 在控制器方法中

public function MoviesDataSearch(Request $request)
{
    $query = Post::query(); // 初始化查询构建器

    // 使用 join 将 posts 表与 posts_tags 表连接起来
    // 注意：这里的 'posts_tags.post_id' 必须是 posts_tags 表中指向 posts 表主键的外键
    $query->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id');

    // 应用父表和子表的过滤条件
    $query->where('posts.post_type', "movie")
          ->where('posts.is_delete', "0");

    if ($request->filled('year')) {
        // 对于年份，通常是精确匹配，如果需要模糊匹配则使用 'like'
        $query->where('posts.year', $request->year);
    }

    if ($request->filled('tag')) {
        // 对于标签ID，通常是精确匹配
        $query->where('posts_tags.tag_id', $request->tag);
    }

    // 确保结果不重复，因为 join 可能会导致父记录重复
    // 如果你只需要父记录，并且不关心子记录的重复，可以使用 distinct()
    $query->distinct('posts.id'); // 确保每个电影只出现一次

    // 排序并分页
    $movies = $query->orderBy('posts.id', 'DESC')->paginate(12);

    // 将所有请求参数添加到分页链接中
    return $movies->appends($request->all());
}

注意事项：

表名限定： 当父表和子表有相同名称的列时（例如 id），必须使用表名.列名的形式明确指定。
外键准确性： join 语句中的连接条件（posts.id', '=', 'posts_tags.post_id'）必须准确无误地反映数据库中的外键关系。
结果重复： 如果一个父记录关联了多个符合条件的子记录，join 可能会导致父记录在结果集中出现多次。使用 distinct() 或 groupBy() 可以解决这个问题，但这取决于你期望的最终结果。

方法二：使用 whereHas 进行关联过滤（更具 Eloquent 风格）

whereHas 是 Eloquent 提供的一种更优雅、更“面向对象”的方式来根据关联模型的属性过滤主模型。它在内部执行子查询，以检查是否存在符合条件的关联记录，但不会将关联记录的数据直接加入到主查询的结果集中。

示例代码：

use App\Models\Posts\Post;
use Illuminate\Http\Request;

// ... 在控制器方法中

public function MoviesDataSearch(Request $request)
{
    $query = Post::where('post_type', "movie")
                 ->where('is_delete', "0");

    // 根据年份过滤（如果请求中包含年份参数）
    if ($request->filled('year')) {
        $query->where('year', $request->year);
    }

    // 根据标签ID过滤（如果请求中包含标签参数）
    if ($request->filled('tag')) {
        // 使用 whereHas 方法过滤关联模型
        // 'PostTags' 是 Post 模型中定义的关系方法名
        $query->whereHas('PostTags', function ($q) use ($request) {
            // 在闭包中定义针对 PostTag 模型的过滤条件
            $q->where('tag_id', $request->tag);
        });
    }

    // 执行查询并分页
    $movies = $query->orderBy('id', 'DESC')->paginate(12);

    // 将所有请求参数添加到分页链接中
    return $movies->appends($request->all());
}

whereHas 的优势：

代码简洁： 更符合 Eloquent 的链式调用风格，提高了可读性。
避免重复： whereHas 默认只返回主模型（Post）的唯一记录，不会出现 join 可能导致的父记录重复问题。
SQL 优化： Eloquent 会生成一个优化的 EXISTS 子查询，通常性能良好。

控制器中的实际应用与优化

结合上述两种方法，我们可以在 MovieController 中实现一个健壮的搜索功能。考虑到用户可能不提供所有筛选条件，我们需要进行条件判断。

where('is_delete', "0");

        // 根据年份过滤（如果请求中包含年份参数）
        // $request->filled('year') 检查参数是否存在且不为空
        if ($request->filled('year')) {
            // 对于从下拉菜单选择的年份，通常是精确匹配
            $query->where('year', $request->year);
        }

        // 根据标签ID过滤（如果请求中包含标签参数）
        if ($request->filled('tag')) {
            // 使用 whereHas 方法过滤关联模型，根据标签ID进行精确匹配
            $query->whereHas('PostTags', function ($q) use ($request) {
                $q->where('tag_id', $request->tag);
            });
        }

        // 执行查询并分页
        // paginate(12) 表示每页显示12条记录
        $movies = $query->orderBy('id', 'DESC')->paginate(12);

        // 将所有请求参数添加到分页链接中，以便在切换页面时保留筛选条件
        return $movies->appends($request->all());
    }
}

前端视图 (movies.blade.php) 示例：

请注意，前端代码中加入了 {{ request('tag') == $tag->id ? 'selected' : '' }} 和 (request('year') == $i ? 'selected' : '') 来保持用户选择的筛选条件，提升用户体验。

注意事项与最佳实践

输入验证： 在控制器中处理用户输入之前，务必进行严格的验证。例如，确保 year 是有效的年份，tag 是存在的标签ID。
性能考量： 对于非常大的数据集和复杂的关联，join 和 whereHas 的性能表现可能有所不同。建议使用 Laravel Debugbar 或 DB::listen() 来分析生成的 SQL 查询，并根据实际情况进行性能优化，例如添加索引。
N+1 问题： 如果在获取到过滤后的电影列表后，还需要访问每个电影的标签信息（例如 $movie->PostTags），请务必使用 with('PostTags') 进行预加载，以避免 N+1 查询问题。
```
$movies = $query->with('PostTags')->orderBy('id', 'DESC')->paginate(12);
```
可读性与维护性： whereHas 通常比手动 join 具有更好的可读性和维护性，尤其是在处理多级嵌套关联时。优先考虑使用 Eloquent 提供的关系查询方法。

总结

在 Laravel 中同时过滤父表和子表数据是常见的需求。通过 join 语句可以直接连接表并应用条件，适用于需要获取所有连接数据或执行复杂聚合的场景。而 whereHas 则提供了一种更符合 Eloquent 哲学的方式，通过子查询高效地过滤主模型，同时保持代码的简洁性和可读性。根据具体的业务需求和性能考量，开发者可以选择最适合的方法来实现高效的数据筛选。

# php # laravel # 前端 # app # 应用开发 # sql # 面向对象 # 对象 # 数据库 # 性能优化 # 分页 # 多个 # 两种 # 链式 # 来实现 # 符合条件 # 是否存在 # 搜索功能 # 更符合 # 器中

返回目录在线咨询

上一篇：Python基于scapy实现修改IP发送请求的方法示例
下一篇：陕西网页设计新趋势：融合地域文化与现代技术

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商