
本教程详细介绍了如何在 laravel 应用中,针对具有父子关系的数据库表(如 `posts` 和 `posts_tags`),同时进行多条件查询和过滤。我们将探讨如何利用 eloquent orm 的 `join` 方法实现跨表数据筛选,以及作为替代方案的 `wherehas` 方法,帮助开发者高效地构建复杂的搜索功能,提升数据检索的灵活性和准确性。
在构建复杂的 Web 应用程序时,经常需要根据来自多个相关表的数据进行过滤和搜索。例如,在一个内容管理系统中,您可能需要根据文章的发布年份(存储在父表 posts 中)和文章关联的标签(存储在子表 posts_tags 中)来搜索文章。本教程将指导您如何在 Laravel 中高效地实现这种父子表联合查询与过滤。
首先,我们回顾一下示例中 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 中标准的一对多关系定义。
用户通过一个包含年份和标签选择框的表单提交搜索请求。
搜索表单 (View)
<form action="{{ route('movies.movie_search') }}" method="GET">
@csrf
<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
$date = date('Y');
for ($i = $date; $i > 1970; $i--) {
echo "<option value=".$i.">".$i."</option>";
}
@endphp
</select>
<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 方法处理。
在控制器中,我们需要根据 Request 对象中传入的 year 和 tag 参数来构建查询。
当需要根据关联表中的字段进行过滤,并且可能需要从关联表中选择数据时,使用数据库 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());
}
}代码解析:
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 更加优雅。如果涉及到从关联表选择数据或更复杂的查询,join 可能是更好的选择。
通过掌握 join 和 whereHas 这两种强大的 Eloquent ORM 方法,您将能够灵活地处理 Laravel 应用程序中各种复杂的父子表联合查询与过滤需求。选择哪种方法取决于您的具体需求、性能考量以及代码可读性的偏好。
以上就是Laravel 中父子表联合查询与过滤:实现多条件搜索教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号