实现Laravel Eloquent：基于模型及关联关系的文件名模糊搜索教程-php教程-PHP中文网

实现Laravel Eloquent：基于模型及关联关系的文件名模糊搜索教程

心靈之曲

发布： 2025-10-26 12:25:34

原创

633人浏览过

实现laravel eloquent：基于模型及关联关系的文件名模糊搜索教程

本文详细介绍了如何使用 Laravel Eloquent ORM 实现对模型及其一对多关联关系中的特定字段进行模糊搜索。通过 `whereHas` 和 `orWhereHas` 方法，可以轻松地在文章的标题、描述以及关联的文件名中查找包含特定字符串的结果。本文将提供详细的代码示例和解释，帮助开发者掌握这种强大的搜索技巧。

在 Laravel 项目中，经常需要根据用户的输入，在数据库中查找匹配的数据。当涉及到模型之间的关联关系时，如何高效地进行搜索就显得尤为重要。本教程将重点介绍如何使用 Laravel Eloquent ORM，在模型自身字段以及其一对多关联关系中的字段中进行模糊搜索。

场景描述

假设我们有一个 Article 模型，它与 ArticleFile 模型之间存在一对多的关系。我们需要根据用户输入的关键词，搜索文章的标题、描述以及关联的文件名，找出所有匹配的文章。

解决方案

Laravel 提供了 whereHas 和 orWhereHas 方法，专门用于查询关联关系是否存在满足特定条件的记录。结合这两个方法，我们可以轻松地实现上述需求。

以下是具体的代码示例：

百灵大模型

蚂蚁集团自研的多模态AI大模型系列

177

查看详情

public function ajax_article_search()
{
  $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>';
    }
  }

  echo $html;
}

登录后复制

代码解释：

Article::where('title', 'like', '%'.$value.'%'): 这部分代码查询 articles 表中 title 字段包含 $value 的记录。like 运算符用于模糊匹配，% 符号表示任意字符。
-youjiankuohaophpcnorWhere('description', 'like', '%'.$value.'%'): 这部分代码查询 articles 表中 description 字段包含 $value 的记录，并使用 orWhere 将其与之前的条件合并，表示满足任一条件即可。
->orWhereHas('files', function ($query) use($value) { ... }): 这是关键部分。orWhereHas('files', ...) 表示查询与 Article 模型关联的 files 关系，并且关联的 ArticleFile 模型需要满足特定条件。
- 'files'：指定要查询的关联关系，这里是 Article 模型中定义的 files() 方法。
- function ($query) use($value) { ... }: 这是一个闭包函数，用于定义关联关系的查询条件。use($value) 将外部变量 $value 传递到闭包函数内部。
- $query->where('filename', 'like', '%'.$value.'%'): 这部分代码查询 article_files 表中 filename 字段包含 $value 的记录。
->get(): 执行查询，并返回所有匹配的 Article 模型实例集合。

注意事项：