本教程详细介绍了如何在 laravel 应用中，针对具有父子关系的数据库表（如 `posts` 和 `posts_tags`），同时进行多条件查询和过滤。我们将探讨如何利用 eloquent orm 的 `join` 方法实现跨表数据筛选，以及作为替代方案的 `wherehas` 方法，帮助开发者高效地构建复杂的搜索功能，提升数据检索的灵活性和准确性。
在构建复杂的 Web 应用程序时，经常需要根据来自多个相关表的数据进行过滤和搜索。例如，在一个内容管理系统中，您可能需要根据文章的发布年份（存储在父表 posts 中）和文章关联的标签（存储在子表 posts_tags 中）来搜索文章。本教程将指导您如何在 Laravel 中高效地实现这种父子表联合查询与过滤。
1. 模型关系概述
首先，我们回顾一下示例中 Post 和 PostTag 模型之间的关系。
Post.php (父模型)
hasMany('AppModelsPostsPostTag'); }}
PostTag.php (子模型)
belongsTo('AppModelsPostsPost'); }}
这里，Post 模型通过 hasMany 方法定义了它拥有多个 PostTag，而 PostTag 模型通过 belongsTo 方法定义了它属于一个 Post。这是 Laravel 中标准的一对多关系定义。
2. 搜索表单与路由
用户通过一个包含年份和标签选择框的表单提交搜索请求。
搜索表单 (View)
@csrf @lang('movies.movie_all') @if ($tags) @foreach ($tags AS $tag) id }}">{{ $tag->name }} @endforeach @endif @lang('public.public_year') @php $date = date('Y'); for ($i = $date; $i > 1970; $i--) { echo "".$i.""; } @endphp
路由定义 (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
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”的方式来过滤基于关联模型的记录。它在内部通常会生成一个子查询，用于检查是否存在满足特定条件的关联记录。
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 中父子表联合查询与过滤：实现多条件搜索教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1339007.html
微信扫一扫 
支付宝扫一扫 
