首页 > 文章 > php教程

Laravel父子表查询与多条件筛选教程

时间：2025-12-16 20:12:51 479浏览收藏

推广推荐

支持 PC / 移动端，安全直达

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Laravel 父子表查询与多条件筛选教程》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

Laravel 中父子表联合查询与过滤：实现多条件搜索教程

本教程详细介绍了如何在 Laravel 应用中，针对具有父子关系的数据库表（如 `posts` 和 `posts_tags`），同时进行多条件查询和过滤。我们将探讨如何利用 Eloquent ORM 的 `join` 方法实现跨表数据筛选，以及作为替代方案的 `whereHas` 方法，帮助开发者高效地构建复杂的搜索功能，提升数据检索的灵活性和准确性。

在构建复杂的 Web 应用程序时，经常需要根据来自多个相关表的数据进行过滤和搜索。例如，在一个内容管理系统中，您可能需要根据文章的发布年份（存储在父表 posts 中）和文章关联的标签（存储在子表 posts_tags 中）来搜索文章。本教程将指导您如何在 Laravel 中高效地实现这种父子表联合查询与过滤。

1. 模型关系概述

首先，我们回顾一下示例中 Post 和 PostTag 模型之间的关系。

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 的一对多关系
    public function PostTags() {
        return $this->hasMany('App\Models\Posts\PostTag');
    }
}

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 的反向一对多关系
    public function GetPost() {
        return $this->belongsTo('App\Models\Posts\Post');
    }
}

这里，Post 模型通过 hasMany 方法定义了它拥有多个 PostTag，而 PostTag 模型通过 belongsTo 方法定义了它属于一个 Post。这是 Laravel 中标准的一对多关系定义。

2. 搜索表单与路由

用户通过一个包含年份和标签选择框的表单提交搜索请求。

搜索表单 (View)

<form action="{{ route('movies.movie_search') }}" method="GET">
    @csrf
    &lt;select name=&quot;tag&quot; class=&quot;select&quot;&gt;
        <option value="" selected="selected">@lang('movies.movie_all')</option>
        @if ($tags)
            @foreach ($tags AS $tag)
                <option value="{{ $tag->id }}">{{ $tag->name }}</option>
            @endforeach
        @endif
    &lt;/select&gt;
    &lt;select name=&quot;year&quot; class=&quot;select&quot;&gt;
        <option value="" selected="selected">@lang('public.public_year')</option>
        @php
            $date = date('Y');
            for ($i = $date; $i > 1970; $i--) {
                echo "<option value=".$i.">".$i."</option>";
            }
        @endphp
    &lt;/select&gt;
    <button type="submit" name="" class="filter">@lang('public.public_filter')</button>
</form>

路由定义 (web.php)

Route::prefix('/movies')->group(function (){
    Route::get('/search', [MovieController::class, 'MoviesDataSearch'])->name('movies.movie_search');
});

表单通过 GET 请求将 tag 和 year 参数发送到 movies.movie_search 路由，由 MovieController 的 MoviesDataSearch 方法处理。

3. 控制器中的查询实现

在控制器中，我们需要根据 Request 对象中传入的 year 和 tag 参数来构建查询。

3.1 使用 join 方法实现联合查询

当需要根据关联表中的字段进行过滤，并且可能需要从关联表中选择数据时，使用数据库 JOIN 操作是最直接有效的方式。

MovieController.php

<?php

namespace App\Http\Controllers\Movies;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\Models\Posts\Post; // 引入 Post 模型
use App\Models\Posts\PostTag; // 引入 PostTag 模型 (虽然在此方案中不直接使用，但仍需引入)

class MovieController extends Controller
{
    public function MoviesDataSearch(Request $request) {
        // 确保 $request 不为空，或根据业务逻辑处理无搜索条件的情况
        // 这里的 empty($request) 判断通常不准确，应判断具体的搜索参数是否存在
        if (empty($request->year) && empty($request->tag)) {
            // 如果没有搜索条件，返回所有电影
            return Post::where('post_type', "movie")
                       ->where('is_delete', "0")
                       ->orderBy('id', 'DESC')
                       ->Paginate(12);
        }

        $query = Post::query(); // 初始化查询构建器

        // 筛选基本条件
        $query->where('posts.post_type', "movie")
              ->where('posts.is_delete', "0");

        // 如果存在年份条件，则添加年份过滤
        if ($request->filled('year')) {
            // 注意：如果 year 是精确匹配，应使用 '=' 而非 'like'
            // 如果需要模糊匹配，使用 'like'
            $query->where('posts.year', $request->year); // 假设是精确匹配
            // 如果是模糊匹配：$query->where('posts.year', 'like', '%'.$request->year.'%');
        }

        // 如果存在标签条件，则进行 JOIN 操作并添加标签过滤
        if ($request->filled('tag')) {
            $query->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id');
            // 注意：如果 tag_id 是精确匹配，应使用 '=' 而非 'like'
            // 如果需要模糊匹配，使用 'like'
            $query->where('posts_tags.tag_id', $request->tag); // 假设是精确匹配
            // 如果是模糊匹配：$query->where('posts_tags.tag_id', 'like', '%'.$request->tag.'%');
        }

        // 为了避免在 JOIN 操作后出现重复的 Post 记录（如果一个 Post 有多个匹配的 PostTag），
        // 并且只关心 Post 本身的数据，可以使用 distinct() 或 groupBy()
        // 但如果只需要 Post 的数据，并且 PostTag 的过滤是排他性的，则可能不需要。
        // 这里我们假设每个 Post 只需要被返回一次，且只关心 Post 自身的数据。
        // 如果需要 PostTag 的数据，则需要指定 select 字段。
        $query->select('posts.*'); // 明确选择 Post 表的所有字段，避免字段名冲突

        $movies = $query->orderBy('posts.id', 'DESC')->Paginate(2);

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

代码解析：

Post::query(): 初始化一个 Eloquent 查询构建器，以便我们可以逐步添加条件。
基本条件: where('posts.post_type', "movie") 和 where('posts.is_delete', "0") 过滤了 posts 表的基本属性。注意，为了避免与 posts_tags 表中可能存在的同名字段冲突，我们明确使用了 posts.post_type 等带表名的字段。
年份过滤: if ($request->filled('year')) { ... } 检查 year 参数是否存在且非空，然后添加 where('posts.year', $request->year) 条件。这里假设 year 是精确匹配，如果您需要模糊匹配，可以使用 like 操作符。
标签过滤: if ($request->filled('tag')) { ... } 检查 tag 参数是否存在且非空。
- $query->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id');: 这是核心部分。它将 posts 表与 posts_tags 表通过 posts.id 和 posts_tags.post_id 字段进行内连接（INNER JOIN）。这意味着只有在两个表中都有匹配记录的行才会被返回。
- $query->where('posts_tags.tag_id', $request->tag);: 在连接后，我们就可以直接在 posts_tags 表的 tag_id 字段上添加过滤条件。同样，这里假设 tag_id 是精确匹配。
*`$query->select('posts.');**: 在执行join操作后，如果两个表中有同名字段（例如id），默认情况下可能会导致冲突或覆盖。通过明确指定select('posts.*')，我们确保只选择posts表的所有字段，避免了不必要的字段冲突，并确保返回的是Post` 模型实例。
orderBy('posts.id', 'DESC'): 排序时同样明确指定表名。
Paginate(2): 对结果进行分页。
$movies->appends($request->all());: 将当前请求的所有参数附加到分页链接中，确保用户在点击分页链接时，原有的搜索条件仍然有效。

3.2 使用 whereHas 方法实现关联表过滤

whereHas 是 Eloquent 提供的一种更“Eloquent”的方式来过滤基于关联模型的记录。它在内部通常会生成一个子查询，用于检查是否存在满足特定条件的关联记录。

<?php

namespace App\Http\Controllers\Movies;

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

class MovieController extends Controller
{
    public function MoviesDataSearch(Request $request) {
        if (empty($request->year) && empty($request->tag)) {
            return Post::where('post_type', "movie")
                       ->where('is_delete', "0")
                       ->orderBy('id', 'DESC')
                       ->Paginate(12);
        }

        $query = Post::where('post_type', "movie")
                     ->where('is_delete', "0");

        // 如果存在年份条件
        if ($request->filled('year')) {
            $query->where('year', $request->year);
        }

        // 如果存在标签条件，使用 whereHas
        if ($request->filled('tag')) {
            $query->whereHas('PostTags', function ($q) use ($request) {
                $q->where('tag_id', $request->tag);
            });
        }

        $movies = $query->orderBy('id', 'DESC')->Paginate(2);

        return $movies->appends($request->all());
    }
}

代码解析：

whereHas('PostTags', function ($q) use ($request) { ... });:
- PostTags 是 Post 模型中定义的关系方法的名称。
- 回调函数 $q 是一个查询构建器实例，它作用于关联模型 PostTag。
- 在回调函数内部，我们添加了针对 PostTag 模型（即 posts_tags 表）的过滤条件 where('tag_id', $request->tag)。
whereHas 的优点在于它更加语义化，更符合 Eloquent 的风格，并且不需要手动处理 JOIN 语句和字段冲突。它主要用于检查是否存在满足条件的关联记录，而不是直接选择关联表的字段。

4. join 与 whereHas 的选择

join:
- 优点: 通常在数据库层面更高效，尤其是在需要从关联表中选择字段、进行聚合或处理更复杂的连接条件时。对于大型数据集，直接的 JOIN 性能可能更优。
- 缺点: 需要手动管理连接条件和字段名冲突（通过 select 明确指定字段），代码可读性相对较低。如果一个父记录有多个子记录满足条件，JOIN 可能会返回重复的父记录行，需要 distinct() 或 groupBy() 来去重。
whereHas:
- 优点: 更符合 Eloquent 的“面向对象”思想，代码更简洁、可读性更高。自动处理子查询逻辑，避免了字段冲突。
- 缺点: 在某些情况下（例如子查询优化不佳或数据集非常庞大时），性能可能略低于手动 JOIN。主要用于检查关联记录的“存在性”，如果需要同时获取关联表的数据，则需要配合 with 进行预加载。

在本教程的场景中，两种方法都能有效实现需求。如果仅仅是根据关联表的存在性进行过滤，whereHas 更加优雅。如果涉及到从关联表选择数据或更复杂的查询，join 可能是更好的选择。

5. 注意事项与最佳实践

输入验证: 在控制器中处理用户输入之前，务必进行严格的验证，防止 SQL 注入和其他安全漏洞。Laravel 提供了强大的验证功能。
精确匹配 vs. 模糊匹配: 根据业务需求选择 where（精确匹配）或 where...like（模糊匹配）。对于年份和标签 ID，通常是精确匹配。
空值处理: 确保您的查询逻辑能够优雅地处理搜索参数为空的情况，如示例中所示，当没有搜索条件时返回所有电影。
性能优化: 对于高流量的应用程序，确保所有用于 WHERE 和 JOIN 条件的字段都已建立数据库索引，这将显著提高查询性能。
可读性: 编写清晰、有注释的代码，尤其是在复杂的查询中。

通过掌握 join 和 whereHas 这两种强大的 Eloquent ORM 方法，您将能够灵活地处理 Laravel 应用程序中各种复杂的父子表联合查询与过滤需求。选择哪种方法取决于您的具体需求、性能考量以及代码可读性的偏好。

到这里，我们也就讲完了《Laravel父子表查询与多条件筛选教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！