Laravel Eloquent：在模型及其关联关系中进行模糊搜索

本文介绍了如何使用 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();

代码解释：

百度文心百中

百度大模型语义搜索体验中心

22

查看详情

1. Article::where('title', 'like', '%'.$value.'%'): 首先，我们查询 Article 模型，筛选出标题包含关键词的文章。like 操作符用于执行模糊匹配，% 符号表示任意字符。
2. ->orWhere('description', 'like', '%'.$value.'%'): 然后，我们使用 orWhere 方法添加一个额外的条件，筛选出描述包含关键词的文章。
3. ->orWhereHas('files', function ($query) use($value) { ... }): 这是关键部分。orWhereHas('files', ...) 表示我们要查询与 Article 模型关联的 files 关系（即 ArticleFile 模型）。
4. function ($query) use($value) { $query->where('filename', 'like', '%'.$value.'%'); }: 这是一个闭包函数，它接收一个 $query 对象作为参数。在这个闭包函数中，我们对 ArticleFile 模型进行查询，筛选出文件名包含关键词的附件。use($value) 用于将外部变量 $value 传递到闭包函数内部。
5. ->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 .= '<a href="'.$article->url.'">';
            $html .= '<p>'.$article->title.'</p>';
            $html .= '</a>';
        }
    }

    return response($html); // 返回 HTML 片段
}

在这个示例中，我们首先从 Request 对象中获取用户输入的关键词，然后使用上述查询代码获取匹配的文章。最后，我们遍历结果集，生成包含文章标题和链接的 HTML 片段，并将其返回给前端。

总结

通过使用 whereHas() 方法，我们可以轻松地在 Laravel Eloquent ORM 中实现对模型及其关联关系的复杂搜索。这种方法不仅代码简洁易懂，而且性能高效。在实际开发中，可以根据具体的需求，灵活地组合 whereHas() 方法和其他查询条件，实现更加复杂的搜索功能。记住要对用户输入进行适当的过滤和转义，以防止 SQL 注入风险。

以上就是Laravel Eloquent：在模型及其关联关系中进行模糊搜索的详细内容，更多请关注php中文网其它相关文章！