Laravel 8 多字段多关键词模糊搜索优化实践-php教程-PHP中文网

Laravel 8 多字段多关键词模糊搜索优化实践

碧海醫心

发布： 2025-12-04 12:31:27

原创

882人浏览过

Laravel 8 多字段多关键词模糊搜索优化实践

本文旨在解决 laravel 8 中进行多字段模糊搜索时，无法正确处理包含多个关键词的搜索请求的问题。通过分析现有 `orwhere` 链式调用的局限性，文章提出了一种优化方案：将用户输入的搜索字符串拆分为多个关键词，并对每个关键词在所有目标字段上分别执行模糊匹配。这种方法能显著提升搜索的灵活性和用户体验，确保即使是复合搜索词也能返回准确的结果。

在 Laravel 应用开发中，实现数据库搜索功能是常见的需求。当用户需要在一个或多个字段中搜索单个关键词时，Laravel Eloquent 提供的 where 和 orWhere 方法能够很好地满足需求。然而，当搜索请求包含多个关键词（例如，“Karol Krawczyk”），并且希望只要其中任一关键词匹配任一目标字段即可返回结果时，简单的 orWhere 链式调用可能会遇到逻辑上的挑战。

现有搜索逻辑的局限性

考虑以下典型的多字段模糊搜索代码片段：

use Illuminate\Http\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'
    );

if (request()->has('search')) {
    $searchValue = request()->input('search.value'); // 假设搜索值是 "Karol Krawczyk"
    $query->where('streets.name', 'like', "%" . $searchValue . "%");
    $query->orWhere('immovables.community', 'like', "%" . $searchValue . "%");
    $query->orWhere('immovables.city', 'like', "%" . $searchValue . "%");
    // ... 其他多个 orWhere 条件
    $query->orWhere('immovables.name', 'like', "%" . $searchValue . "%");
    $query->orWhere('immovables.surname', 'like', "%" . $searchValue . "%");
    // ...
}
$results = $query->get();

登录后复制

上述代码的问题在于，它将用户输入的整个搜索字符串（例如 "Karol Krawczyk"）作为一个整体去匹配每个字段。这意味着，如果数据库中 immovables.name 字段的值是 "Karol"，immovables.surname 字段的值是 "Krawczyk"，那么当 $searchValue 为 "Karol Krawczyk" 时，上述查询将无法返回结果。因为没有一个字段会同时包含 "Karol Krawczyk" 这个完整的字符串。理想情况下，我们希望只要“Karol”匹配到 name 字段，或者“Krawczyk”匹配到 surname 字段，就应该返回该记录。

优化方案：多关键词拆分与分组匹配

为了解决上述问题，核心思路是将用户输入的搜索字符串拆分成独立的关键词，然后对每个关键词在所有目标字段上分别执行模糊匹配。Laravel 的查询构建器提供了闭包（Closure）功能，可以优雅地实现复杂的 WHERE 条件分组。

以下是优化后的代码实现：

use Illuminate\Http\Request; // 确保导入 Request 类

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',
                'immovables.community', // 确保所有搜索字段都在 select 中，如果需要显示
                'immovables.city',
                'immovables.name',
                'immovables.surname'
                // ... 其他可能需要显示的字段
            );

        // 检查是否存在搜索请求
        if ($request->has('search') && !empty($request->input('search.value'))) {
            $searchValue = $request->input('search.value');
            // 按空格分割搜索词，并过滤掉空字符串
            $searchTerms = array_filter(explode(" ", $searchValue), 'strlen');

            if (!empty($searchTerms)) {
                // 使用 where 子句的闭包来确保逻辑分组的正确性
                // 这将生成类似 WHERE (condition_for_term1 OR condition_for_term2 ...) 的 SQL
                $query->where(function ($q) use ($searchTerms) {
                    foreach ($searchTerms as $term) {
                        $term = trim($term); // 清理每个搜索词，去除首尾空格
                        if (empty($term)) {
                            continue; // 再次检查，避免空词导致无效查询
                        }

                        // 对每个搜索词，在所有目标字段上执行 OR 匹配
                        // 这里的 orWhere 链式调用确保了每个 term 内部是 OR 关系
                        // 并且不同 term 之间的条件也是 OR 关系
                        $q->orWhere('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('immovables.index', compact('results'));
    }
}

登录后复制

优化逻辑解析

获取并清理搜索值：$searchValue = $request->input('search.value'); 从请求中获取搜索字符串。 $searchTerms = array_filter(explode(" ", $searchValue), 'strlen'); 将搜索字符串按空格分割成数组。array_filter 和 'strlen' 回调函数用于移除分割后可能产生的空字符串，例如用户输入多个空格时。
使用 where 闭包进行条件分组：$query->where(function ($q) use ($searchTerms) { ... }); 是实现此功能的核心。它允许我们创建一个嵌套的 WHERE 子句。在这个闭包内部，所有的条件都会被 OR 逻辑连接起来，并且整个闭包的结果会作为一个独立的 WHERE 条件与主查询的其他条件（如果有的话）通过 AND 连接。例如，如果主查询有 WHERE status = 'active'，那么最终的 SQL 会是 WHERE status = 'active' AND (search_conditions)。
遍历关键词并应用 orWhere：foreach ($searchTerms as $term) 循环遍历每个分割后的关键词。 $term = trim($term); 再次清理关键词，确保没有多余的空格。 $q->orWhere('字段名', 'like', "%" . $term . "%")：对于每个关键词，我们都在所有目标字段上使用 orWhere 进行模糊匹配。这意味着，只要当前关键词匹配了任何一个指定的字段，该记录就符合条件。由于所有这些 orWhere 调用都在同一个闭包内，它们之间自然形成了 OR 关系。

通过这种方式，如果用户输入 "Karol Krawczyk"，系统会首先搜索包含 "Karol" 的记录（在 name、surname 或其他字段中），然后搜索包含 "Krawczyk" 的记录（在 name、surname 或其他字段中），并将所有符合任一条件的记录返回。

蚂蚁PPT

AI在线智能生成PPT

113

查看详情

注意事项与最佳实践

性能考量：
- LIKE %value% 的性能： 在大量数据上使用 LIKE %value%（以通配符开头）通常无法利用常规 B-tree 索引，可能导致全表扫描，从而影响查询性能。
- 多 OR 条件： 大量的 orWhere 条件也会增加查询的复杂性和执行时间。
- 解决方案： 对于大型数据集或高并发场景，建议考虑更专业的全文搜索解决方案，例如：
  - MySQL Full-Text Search： 如果数据库是 MySQL，可以利用其内置的全文索引功能。
  - Elasticsearch： 强大的分布式搜索和分析引擎，提供高性能的全文搜索。
  - Algolia/MeiliSearch： 托管或自托管的搜索服务，专注于提供快速、相关的搜索体验。
数据库索引： 确保所有参与 LIKE 搜索的字段都建立了适当的索引。虽然 LIKE %value% 无法利用 B-tree 索引，但对于 LIKE value%（通配符在末尾）或 WHERE 条件中没有通配符的情况，索引仍然至关重要。
用户体验： 可以在前端界面提示用户，可以使用空格来分隔多个关键词进行更灵活的搜索。
安全性： Laravel 的 Eloquent 查询构建器和 Request::input() 方法已经内置了 SQL 注入防护，所以直接使用 $term 变量通常是安全的。
更复杂的搜索逻辑： 如果需要实现“同时包含所有关键词”的 AND 逻辑（例如，搜索结果必须同时包含“Karol”和“Krawczyk”），则需要调整闭包内部的逻辑，可能需要为每个关键词创建一个独立的 where 闭包，然后将这些闭包用 AND 连接起来。

总结

通过将用户输入的搜索字符串拆分为多个关键词，并利用 Laravel 查询构建器的 where 闭包和 orWhere 方法进行分组匹配，我们能够有效解决多字段多关键词模糊搜索的难题。这种方法显著提升了搜索的灵活性和用户体验，使得用户能够通过更自然的语言进行搜索并获得准确的结果。在实际应用中，开发者应根据数据量和性能要求，权衡是否需要引入更高级的全文搜索技术。

以上就是Laravel 8 多字段多关键词模糊搜索优化实践的详细内容，更多请关注php中文网其它相关文章！