Laravel Eloquent 关联查询：同时过滤父子表数据-php教程-PHP中文网

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

霞舞

发布： 2025-11-28 12:45:06

原创

190人浏览过

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)

<?php
namespace App\Models\Posts;

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

class Post extends Model
{
    use HasFactory;

    protected $table = "posts";
    protected $guarded = [];

    /**
     * 定义与 PostTag 模型的一对多关系。
     * 一个 Post 可以有多个 PostTag。
     */
    public function PostTags()
    {
        return $this->hasMany(PostTag::class);
    }
}

登录后复制

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

<?php
namespace App\Models\Posts;

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

class PostTag extends Model
{
    use HasFactory;

    protected $table = "posts_tags";
    protected $guarded = [];

    /**
     * 定义与 Post 模型的多对一关系。
     * 一个 PostTag 属于一个 Post。
     */
    public function GetPost()
    {
        return $this->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());
}

登录后复制

注意事项：

Lifetoon

免费的AI漫画创作平台

查看详情

表名限定： 当父表和子表有相同名称的列时（例如 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 中实现一个健壮的搜索功能。考虑到用户可能不提供所有筛选条件，我们需要进行条件判断。

<?php

namespace App\Http\Controllers\Movies;

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

class MovieController extends Controller
{
    /**
     * 根据标签和年份过滤电影数据。
     *
     * @param Request $request
     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator
     */
    public function MoviesDataSearch(Request $request)
    {
        // 初始化查询构建器，应用基础过滤条件
        $query = Post::where('post_type', "movie")
                     ->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) 示例：

<form action="{{ route('movies.movie_search') }}" method="GET">
    <select name="tag" class="select">
        <option value="" selected="selected">@lang('movies.movie_all_tags')</option>
        @if ($tags)
            @foreach ($tags AS $tag)
                <option value="{{ $tag->id }}" {{ request('tag') == $tag->id ? 'selected' : '' }}>
                    {{ $tag->name }}
                </option>
            @endforeach
        @endif
    </select>
    <select name="year" class="select">
        <option value="" selected="selected">@lang('public.public_all_years')</option>
        @php
            $currentYear = date('Y');
            for ($i = $currentYear; $i > 1970; $i--) {
                echo "<option value=\"".$i."\" ". (request('year') == $i ? 'selected' : '') .">".$i."</option>";
            }
        @endphp
    </select>
    <button type="submit" class="filter">
        @lang('public.public_filter')
    </button>
</form>

登录后复制

请注意，前端代码中加入了 {{ 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 哲学的方式，通过子查询高效地过滤主模型，同时保持代码的简洁性和可读性。根据具体的业务需求和性能考量，开发者可以选择最适合的方法来实现高效的数据筛选。

以上就是Laravel Eloquent 关联查询：同时过滤父子表数据的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

在自定义PHP页面中高效访问WooCommerce数据 PHP PDO lastInsertId()失效：深度解析与连接复用策略 PHP 枚举：从字符串获取非 Backed Enum 案例的实现方法 Nginx配置指南：解决Symfony应用中静态文件（如PDF）下载失败问题使用PHP和MySQL构建多级垂直分类菜单的实战指南