本文介绍了如何使用 Laravel Eloquent ORM 在模型及其一对多关联关系中执行模糊搜索。我们将探讨如何利用 whereHas() 方法查询关联模型，并提供示例代码和注意事项，帮助开发者高效地实现复杂的搜索功能。
在 Laravel 项目中，经常需要根据用户输入的关键词，在数据库中查找匹配的数据。当需要搜索的字段不仅存在于主表中，还存在于与主表存在关联的子表中时，就需要使用更高级的查询技巧。本文将重点介绍如何利用 Eloquent ORM 的 whereHas() 方法，实现对模型及其一对多关联关系的模糊搜索。
使用 whereHas() 查询关联关系
whereHas() 方法允许我们在查询主模型时，同时对关联模型进行条件筛选。只有当关联模型满足指定的条件时，主模型才会被包含在结果集中。
例如，假设我们有一个 Article 模型，它与 ArticleFile 模型之间存在一对多关系（一个文章可以有多个附件）。现在我们需要查找文章标题或描述包含关键词，或者附件文件名包含关键词的文章。
以下是实现这一目标的 Eloquent 查询代码：
$value = $_POST['value']; // 假设关键词来自 POST 请求
$articles = Article::where('title', 'like', '%'.$value.'%')
->orWhere('description', 'like', '%'.$value.'%')
->orWhereHas('files', function ($query) use($value) {
$query->where('filename', 'like', '%'.$value.'%');
})
->get();代码解释：
- Article::where('title', 'like', '%'.$value.'%'): 首先，我们查询 Article 模型，筛选出标题包含关键词的文章。like 操作符用于执行模糊匹配，% 符号表示任意字符。
- ->orWhere('description', 'like', '%'.$value.'%'): 然后，我们使用 orWhere 方法添加一个额外的条件，筛选出描述包含关键词的文章。
- ->orWhereHas('files', function ($query) use($value) { ... }): 这是关键部分。orWhereHas('files', ...) 表示我们要查询与 Article 模型关联的 files 关系（即 ArticleFile 模型）。
- function ($query) use($value) { $query->where('filename', 'like', '%'.$value.'%'); }: 这是一个闭包函数，它接收一个 $query 对象作为参数。在这个闭包函数中，我们对 ArticleFile 模型进行查询，筛选出文件名包含关键词的附件。use($value) 用于将外部变量 $value 传递到闭包函数内部。
- ->get(): 最后，我们执行查询，获取满足所有条件的 Article 模型集合。
注意事项：
- whereHas() 方法只返回主模型（Article），即使关联模型（ArticleFile）满足条件。如果你需要获取关联模型的详细信息，需要在循环遍历 Article 模型时，访问其 files 关系。
- use($value) 语句非常重要，它确保闭包函数可以访问外部变量 $value。
- 请注意 SQL 注入风险。如果关键词 $value 来自用户输入，务必进行适当的过滤和转义，以防止恶意代码注入。可以使用 Laravel 提供的 e() 函数进行转义。
完整示例
以下是一个完整的示例，展示如何在控制器中使用上述代码：
use App\Models\Article;
use Illuminate\Http\Request;
public function ajax_article_search(Request $request)
{
$value = $request->input('value'); // 获取 POST 请求中的 'value' 参数
$html = '';
if($value) {
$articles = Article::where('title', 'like', '%'.$value.'%')
->orWhere('description', 'like', '%'.$value.'%')
->orWhereHas('files', function ($query) use($value) {
$query->where('filename', 'like', '%'.$value.'%');
})
->get();
foreach($articles as $article) {
$html .= '';
$html .= ''.$article->title.'
';
$html .= '';
}
}
return response($html); // 返回 HTML 片段
}在这个示例中，我们首先从 Request 对象中获取用户输入的关键词，然后使用上述查询代码获取匹配的文章。最后，我们遍历结果集，生成包含文章标题和链接的 HTML 片段，并将其返回给前端。
总结
通过使用 whereHas() 方法，我们可以轻松地在 Laravel Eloquent ORM 中实现对模型及其关联关系的复杂搜索。这种方法不仅代码简洁易懂，而且性能高效。在实际开发中，可以根据具体的需求，灵活地组合 whereHas() 方法和其他查询条件，实现更加复杂的搜索功能。记住要对用户输入进行适当的过滤和转义，以防止 SQL 注入风险。
