本文旨在指导如何在 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)
<?phpnamespace 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 模型 (app/Models/Posts/PostTag.php)
<?phpnamespace 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); }}登录后复制方法一：使用 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漫画创作平台
92 查看详情 
表名限定： 当父表和子表有相同名称的列时（例如 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 中实现一个健壮的搜索功能。考虑到用户可能不提供所有筛选条件，我们需要进行条件判断。
<?phpnamespace 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::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中文网其它相关文章！
