LaravelEloquent父子表筛选技巧教程
时间：2025-11-27 16:18:38 454浏览 收藏
本文详细介绍了在 Laravel 框架中，如何利用 Eloquent ORM 对具有父子关系的表数据进行高效筛选。针对 Laravel 应用中常见的需求，文章以 `Post` 和 `PostTag` 模型为例，深入讲解了两种核心实现方法：**`join` 子句**和 **`whereHas` 方法**。`join` 子句通过直接数据库连接实现筛选，性能优秀，但需注意处理列名冲突和数据重复问题；`whereHas` 方法则更符合 Eloquent 风格，代码简洁易读，能自动处理连接逻辑。本文通过具体的代码示例，演示了如何根据父表字段（如年份）和子表字段（如标签ID）构建灵活的过滤逻辑，并提供最佳实践建议，助力开发者提升 Laravel 应用的数据查询效率与用户体验。无论选择哪种方法，理解其优缺点并结合实际场景，才能编写出高效且可维护的代码。
本教程详细阐述了如何在 Laravel 中利用 Eloquent ORM 同时对父表和子表数据进行筛选。文章将深入探讨两种核心方法：使用 `join` 子句进行直接数据库连接，以及采用 `whereHas` 方法实现更具 Eloquent 风格的关联查询。通过实际代码示例，您将学会如何根据父表的字段（如年份）和子表的字段（如标签ID）构建高效且可读的过滤逻辑，并集成到控制器和视图中。
在 Laravel 应用开发中，我们经常需要处理具有一对多或多对多关系的数据。当用户需要根据父表和其关联子表的字段同时进行筛选时，如何高效地构建查询是关键。本教程将以 Post (父表) 和 PostTag (子表) 为例，演示如何实现这一需求，具体涉及根据 Post 表的 year 字段和 PostTag 表的 tag_id 字段进行过滤。
1. 模型及关系定义
首先，确保您的 Eloquent 模型已正确定义了它们之间的关系。在本例中，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 = [];
/**
* 获取文章的所有标签。
*/
public function PostTags()
{
return $this->hasMany(PostTag::class);
}
}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 = [];
/**
* 获取此标签所属的文章。
*/
public function GetPost()
{
return $this->belongsTo(Post::class);
}
}2. 视图中的筛选表单
用户通过一个包含年份和标签选择的表单来提交筛选请求。
View (movies/search_form.blade.php)
<form action="{{ route('movies.movie_search') }}" method="GET">
<select name="tag" class="select">
<option value="" selected="selected">@lang('movies.movie_all')</option>
@if ($tags)
@foreach ($tags AS $tag)
<option value="{{ $tag->id }}">{{ $tag->name }}</option>
@endforeach
@endif
</select>
<select name="year" class="select">
<option value="" selected="selected">@lang('public.public_year')</option>
@php
$currentYear = date('Y');
for ($i = $currentYear; $i > 1970; $i--) {
echo "<option value=\"".$i."\">".$i."</option>";
}
@endphp
</select>
<button type="submit" class="filter">@lang('public.public_filter')</button>
</form>3. 路由定义
定义一个 GET 路由来处理筛选请求。
web.php
Route::prefix('/movies')->group(function () {
Route::get('/search', [MovieController::class, 'MoviesDataSearch'])->name('movies.movie_search');
});4. 控制器中的筛选逻辑
在控制器中，我们将介绍两种实现父子表同时筛选的方法：使用 join 子句和使用 whereHas 方法。
4.1 方法一：使用 join 子句
join 子句允许您直接在数据库层面连接两个或多个表，然后对连接后的结果进行筛选。这种方法通常在需要高性能或需要直接访问连接表中所有列时非常有用。
优点：
- 性能通常较好，尤其是在处理大量数据时。
- 可以直接在查询中访问所有连接表的列。
缺点：
- 如果不对 select 语句进行处理，可能会出现列名冲突。
- 如果一个父记录有多个匹配的子记录，可能会导致父记录重复出现，需要使用 distinct() 或 groupBy() 来避免。
MovieController.php (使用 join)
<?php
namespace App\Http\Controllers\Movies;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\Models\Posts\Post;
use App\Models\Posts\PostTag; // 引入 PostTag 模型
class MovieController extends Controller
{
public function MoviesDataSearch(Request $request)
{
$query = Post::query();
// 基础过滤条件
$query->where('posts.post_type', "movie")
->where('posts.is_delete', "0");
// 如果存在标签筛选，则使用 join 连接 posts_tags 表
if ($request->filled('tag')) {
// 注意：'posts_tags.post_id' 是 PostTag 模型中指向 Post 模型的外键
$query->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id')
->where('posts_tags.tag_id', $request->tag); // 假设 tag_id 是精确匹配
// 如果需要模糊匹配，可以使用 ->where('posts_tags.tag_id', 'like', '%'.$request->tag.'%');
}
// 如果存在年份筛选
if ($request->filled('year')) {
$query->where('posts.year', 'like', '%'.$request->year.'%');
}
// 避免因 join 导致重复的 Post 记录，并仅选择 Post 表的列
$movies = $query->select('posts.*')
->distinct() // 确保每个 Post 记录只出现一次
->orderBy('posts.id', 'DESC')
->paginate(12); // 分页大小可根据需求调整
// 保持筛选参数在分页链接中
return $movies->appends($request->all());
}
}注意事项：
- join('posts_tags', 'posts.id', '=', 'posts_tags.post_id'): 这里的 posts_tags.post_id 是 PostTag 表中关联 Post 表的外键。请根据您的实际数据库结构调整。
- select('posts.*'): 在使用 join 时，为了避免返回重复的列名或不必要的子表数据，通常建议明确指定要选择的列。
- distinct(): 如果一个 Post 记录有多个 PostTag 匹配筛选条件，join 可能会导致该 Post 记录在结果集中出现多次。distinct() 可以确保每个 Post 记录只返回一次。
4.2 方法二：使用 whereHas 方法
whereHas 是 Eloquent 提供的一种更高级、更具对象化风格的方法，用于根据关联模型的条件来筛选父模型。它会在底层生成一个 EXISTS 子查询。
优点：
- 代码更简洁，更符合 Eloquent 的设计理念。
- 自动处理连接逻辑，无需手动指定 join 条件。
- 避免了 join 可能导致的重复父记录问题。
缺点：
- 对于非常复杂的关联查询或需要高度优化性能的场景，有时 join 可能更直接高效。
- 无法直接选择关联模型的列。
MovieController.php (使用 whereHas)
<?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)
{
$query = Post::query();
// 基础过滤条件
$query->where('post_type', "movie")
->where('is_delete', "0");
// 如果存在年份筛选
if ($request->filled('year')) {
$query->where('year', 'like', '%'.$request->year.'%');
}
// 如果存在标签筛选，则使用 whereHas
if ($request->filled('tag')) {
$query->whereHas('PostTags', function ($q) use ($request) {
// 在关联模型 PostTag 上应用筛选条件
$q->where('tag_id', $request->tag); // 假设 tag_id 是精确匹配
// 如果需要模糊匹配，可以使用 $q->where('tag_id', 'like', '%'.$request->tag.'%');
});
}
$movies = $query->orderBy('id', 'DESC')
->paginate(12);
// 保持筛选参数在分页链接中
return $movies->appends($request->all());
}
}注意事项：
- whereHas('PostTags', function ($q) use ($request) { ... }): PostTags 是在 Post 模型中定义的关系方法名。闭包函数 $q 代表了对 PostTag 模型进行的查询。
- $request->filled('year') 和 $request->filled('tag'): 使用 filled() 方法可以检查请求参数是否存在且非空，这有助于构建更健壮的条件查询。
5. 总结与最佳实践
- 选择方法：
- 如果您需要直接从关联表中选择列，或者对性能有极高要求且熟悉 SQL JOIN 语句的优化，join 方法可能更适合。
- 如果您追求代码的 Eloquent 风格、可读性，并且主要目的是根据关联条件筛选父模型，那么 whereHas 是更推荐的选择。它通常能满足大部分业务需求，并且更不容易引入重复记录的问题。
- 条件查询： 在控制器中，使用 if ($request->filled('param')) 或 Eloquent 的 when() 方法来根据请求参数的有无动态构建查询条件，可以使代码更加灵活和健壮。
// 使用 when() 的示例 $movies = Post::where('post_type', "movie") ->where('is_delete', "0") ->when($request->filled('year'), function ($query) use ($request) { return $query->where('year', 'like', '%'.$request->year.'%'); }) ->when($request->filled('tag'), function ($query) use ($request) { return $query->whereHas('PostTags', function ($q) use ($request) { $q->where('tag_id', $request->tag); }); }) ->orderBy('id', 'DESC') ->paginate(12); - 分页链接： 务必使用 $movies->appends($request->all()) 来确保在分页时，所有当前的筛选参数都能被保留，从而提供更好的用户体验。
- 外键匹配： 无论是 join 还是 whereHas，都依赖于正确的外键关系。请确保您的数据库表和 Eloquent 模型中的外键定义是准确无误的。
- 输入验证： 在实际应用中，始终对用户输入进行验证（例如，使用 Laravel 的表单请求验证），以防止恶意数据或不符合预期的数据影响查询。
通过掌握 join 和 whereHas 这两种强大的 Eloquent 查询方法，您将能够灵活高效地处理 Laravel 中父子表数据的复杂筛选需求。
到这里，我们也就讲完了《LaravelEloquent父子表筛选技巧教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！
相关阅读
更多>
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
363 收藏
-
318 收藏
-
276 收藏
-
152 收藏
-
451 收藏
-
183 收藏
-
407 收藏
-
187 收藏
-
438 收藏
-
159 收藏
-
156 收藏
-
361 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
- 立即学习 485次学习