Laravel8多关键词模糊搜索实现方法

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Laravel 8 多关键词模糊搜索方法与实现》，聊聊，我们一起来看看吧！

本文针对 Laravel 8 中使用 `orWhere` 进行多字段、多关键词模糊搜索时遇到的挑战，深入探讨了如何通过分词处理用户输入，并结合 Laravel 查询构建器的嵌套 `where` 子句，实现更灵活、准确的搜索逻辑。文章提供了详细的代码示例和性能优化建议，旨在帮助开发者构建高效且用户友好的搜索功能。

引言：多关键词模糊搜索的挑战

在 Laravel 应用中，为数据库模型实现搜索功能是常见的需求。当需要在一个或多个字段中进行模糊匹配时，where('field', 'like', '%keyword%') 或 orWhere('field', 'like', '%keyword%') 是常用的方法。然而，这种简单的模式在处理用户输入多个关键词（例如 "Karol Krawczyk"）时，往往会遇到问题。

考虑以下场景：用户希望搜索姓名为 "Karol Krawczyk" 的记录，其中 "Karol" 可能存储在 name 字段，而 "Krawczyk" 存储在 surname 字段。如果直接使用原始的搜索逻辑：

$query->where('immovables.name', 'like', "%Karol Krawczyk%");
$query->orWhere('immovables.surname', 'like', "%Karol Krawczyk%");
// ... 其他字段

这样的查询将尝试在 name 或 surname 字段中查找完整的字符串 "Karol Krawczyk"。如果数据库中 name 字段的值是 "Karol"，surname 字段的值是 "Krawczyk"，则上述查询将无法匹配到任何结果，因为没有一个字段完整包含 "Karol Krawczyk" 这个字符串。这导致了搜索结果不准确或缺失的问题。

核心策略：分词与条件分组

要解决上述问题，核心策略在于对用户输入的搜索字符串进行“分词”处理，并将每个分词后的关键词作为独立的搜索条件。具体来说，我们需要将 "Karol Krawczyk" 拆分为 "Karol" 和 "Krawczyk" 两个独立的关键词。然后，对于每个关键词，我们构建一组 OR 条件，使其在所有目标字段中进行模糊匹配。最后，将这些关键词的搜索条件组通过 OR 逻辑连接起来，即：如果任一关键词在任一目标字段中匹配成功，则该记录应被检索。

这种策略能够实现更灵活的模糊搜索，例如，用户输入 "Karol Krawczyk" 时，查询逻辑将变为：

(streets.name LIKE '%Karol%' OR immovables.name LIKE '%Karol%' OR immovables.surname LIKE '%Karol%' OR ...)OR(streets.name LIKE '%Krawczyk%' OR immovables.name LIKE '%Krawczyk%' OR immovables.surname LIKE '%Krawczyk%' OR ...)

这样，只要 "Karol" 匹配到 name 字段，或者 "Krawczyk" 匹配到 surname 字段（或者其他任何字段），该记录都会被包含在结果中。

实现步骤与代码示例

在 Laravel 8 中，我们可以利用查询构建器的闭包功能来优雅地实现分词与条件分组。

1. 初始化查询构建器

首先，像往常一样初始化你的 Eloquent 查询，包括任何必要的联接和选择字段：

use Illuminate\Http\Request;
use App\Models\Immovable; // 假设你的模型是 Immovable

class ImmovableController extends Controller
{
    public function index(Request $request)
    {
        $query = Immovable::query()
            ->leftJoin('streets', 'streets.gus_id', '=', 'immovables.street_gus_id')
            ->select(
                'immovables.id',
                'immovables.street_gus_id',
                'immovables.building_number',
                'immovables.apartment_number',
                'streets.name as street_name'
            );

        // ... 接下来添加搜索条件
    }
}

2. 处理搜索输入并构建动态查询条件

接下来是实现多关键词搜索的核心逻辑。我们将检查请求中是否存在 search 参数，然后对搜索值进行分词，并使用嵌套的 where 闭包来构建复杂的 OR 条件组。

        if ($request->has('search') && !empty($request->search['value'])) {
            // 获取搜索值并按空格分割成关键词数组
            $searchTerms = explode(" ", $request->search['value']);

            // 过滤掉空字符串，以防用户输入多个空格
            $searchTerms = array_filter($searchTerms);

            // 如果存在有效的搜索关键词，则构建查询条件
            if (!empty($searchTerms)) {
                $query->where(function ($subQuery) use ($searchTerms) {
                    foreach ($searchTerms as $term) {
                        // 对每个关键词，构建一个 OR 条件组
                        // 确保每个关键词在任一指定字段中匹配
                        $subQuery->orWhere(function ($innerSubQuery) use ($term) {
                            $innerSubQuery->where('streets.name', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.community', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.city', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.building_number', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.granted_comments', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.inspections', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.oze_installations', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.pesel', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.name', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.surname', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.email1', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.email2', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.email3', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.phone1', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.phone2', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.phone3', 'like', "%" . $term . "%")
                                          ->orWhere('immovables.description', 'like', "%" . $term . "%");
                        });
                    }
                });
            }
        }

        // 执行查询并获取结果
        $results = $query->get();

        return view('your.view', compact('results'));
    }
}

代码解析：

1. explode(" ", $request->search['value']): 这行代码将用户输入的搜索字符串以空格为分隔符拆分成一个数组。例如，"Karol Krawczyk" 会变成 ['Karol', 'Krawczyk']。
2. array_filter($searchTerms): 用于移除 explode 可能会产生的空字符串元素（例如，如果用户输入 "Karol Krawczyk "）。
3. $query->where(function ($subQuery) use ($searchTerms) { ... }): 这是外层闭包，它将所有关键词的搜索条件包裹在一个 WHERE (...) 组中。这意味着所有关键词的

到这里，我们也就讲完了《Laravel8多关键词模糊搜索实现方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！