Laravel 8 多关键词数据库搜索优化实践-php教程-PHP中文网

Laravel 8 多关键词数据库搜索优化实践

聖光之護

发布： 2025-12-01 12:03:06

原创

647人浏览过

Laravel 8 多关键词数据库搜索优化实践

本文旨在解决 laravel 8 中处理多关键词搜索时遇到的常见问题，特别是当用户输入包含多个词（如“名姓”）的搜索字符串时，传统 `orwhere` 查询无法正确匹配的挑战。文章将详细介绍一种优化策略，通过将搜索字符串拆分为独立关键词，并对每个关键词应用灵活的 `orwhere` 逻辑，从而实现更强大、更准确的多关键词数据库搜索功能，显著提升用户搜索体验。

问题分析：传统搜索的局限性

在 Laravel 8 中进行数据库搜索时，开发者通常会使用 Eloquent ORM 提供的 where 和 orWhere 方法来构建查询条件。当搜索条件涉及多个字段时，通过链式调用 orWhere 可以实现“任一字段匹配”的逻辑。然而，这种方法在处理用户输入的多关键词搜索时，会遇到一个常见的局限性。

考虑以下场景：用户在搜索框中输入“Karol Krawczyk”，期望能找到姓名为“Karol Krawczyk”或姓名中包含这两个词的记录。如果原始查询逻辑如下：

$query = Immovable::query()
    // ... 其他查询条件和联接 ...
    ->select('immovables.id', /* ... 其他字段 ... */);

if (request()->has('search')) {
    $searchTerm = $request->search['value'];
    $query->where('streets.name', 'like', "%" . $searchTerm . "%");
    $query->orWhere('immovables.community', 'like', "%" . $searchTerm . "%");
    // ... 更多 orWhere 条件，包括 immovables.name 和 immovables.surname ...
    $query->orWhere('immovables.name', 'like', "%" . $searchTerm . "%");
    $query->orWhere('immovables.surname', 'like', "%" . $searchTerm . "%");
}
$results = $query->get();

登录后复制

当 $searchTerm 为 "Karol Krawczyk" 时，上述查询会尝试在 streets.name、immovables.community、immovables.name、immovables.surname 等字段中查找包含完整字符串 "Karol Krawczyk" 的记录。如果数据库中 immovables.name 字段存储的是 "Karol"，而 immovables.surname 字段存储的是 "Krawczyk"，那么单独的 immovables.name LIKE '%Karol Krawczyk%' 或 immovables.surname LIKE '%Karol Krawczyk%' 都将无法匹配，导致搜索结果为空。这正是传统单一字符串匹配逻辑的局限所在。

优化策略：多关键词拆分与组合查询

为了解决上述问题，我们需要一种更灵活的搜索策略：将用户输入的搜索字符串拆分成独立的关键词，并对每个关键词在所有目标字段上应用 OR 逻辑进行匹配。这样，无论关键词出现在哪个字段，只要有任一关键词匹配，记录就能被检索出来。

核心思路如下：

Remove.bg

AI在线抠图软件，图片去除背景

174

查看详情

获取并拆分搜索值： 从请求中获取用户输入的搜索字符串，并使用空格作为分隔符将其拆分成一个关键词数组。
遍历关键词构建查询： 遍历每个拆分出的关键词。对于每个关键词，在所有需要搜索的字段上构建 LIKE 匹配条件。
动态连接查询条件： 使用 OR 逻辑连接所有关键词及其字段的匹配条件。为了确保 SQL 语法的正确性，第一个关键词的第一个字段匹配应使用 where，后续的所有匹配（包括同一关键词的其他字段以及所有后续关键词的所有字段）都使用 orWhere。

这种方法将确保即使搜索词分散在不同的字段中，也能被正确匹配。例如，当搜索 "Karol Krawczyk" 时，它会查找包含 "Karol" 的记录，或者包含 "Krawczyk" 的记录，从而实现更强大的搜索功能。

实现步骤与示例代码

以下是使用 Laravel Eloquent 实现多关键词搜索优化的具体代码示例：

use Illuminate\Http\Request;
use App\Models\Immovable; // 假设您的模型名为 Immovable

class SearchController extends Controller
{
    public function search(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'
            );

        // 检查是否存在搜索参数
        if ($request->has('search') && !empty($request->search['value'])) {
            // 1. 拆分搜索字符串为关键词数组
            $searches = explode(" ", $request->search['value']);

            // 2. 遍历每个关键词，构建动态查询条件
            foreach ($searches as $index => $search) {
                // 清理关键词，移除空字符串
                $search = trim($search);
                if (empty($search)) {
                    continue;
                }

                // 对于每个关键词，将其应用于所有目标字段
                // 使用 where(function($q){...}) 确保每个关键词的 OR 条件被正确分组
                $query->orWhere(function ($subQuery) use ($search, $index) {
                    // 对于第一个关键词，第一个字段使用 where，后续字段使用 orWhere
                    // 对于后续关键词，所有字段都使用 orWhere (因为外层已经是 orWhere(function(){...}))
                    $subQuery->where('streets.name', 'like', "%" . $search . "%")
                             ->orWhere('immovables.community', 'like', "%" . $search . "%")
                             ->orWhere('immovables.city', 'like', "%" . $search . "%")
                             ->orWhere('immovables.building_number', 'like', "%" . $search . "%")
                             ->orWhere('immovables.granted_comments', 'like', "%" . $search . "%")
                             ->orWhere('immovables.inspections', 'like', "%" . $search . "%")
                             ->orWhere('immovables.oze_installations', 'like', "%" . $search . "%")
                             ->orWhere('immovables.pesel', 'like', "%" . $search . "%")
                             ->orWhere('immovables.name', 'like', "%" . $search . "%")
                             ->orWhere('immovables.surname', 'like', "%" . $search . "%")
                             ->orWhere('immovables.email1', 'like', "%" . $search . "%")
                             ->orWhere('immovables.email2', 'like', "%" . $search . "%")
                             ->orWhere('immovables.email3', 'like', "%" . $search . "%")
                             ->orWhere('immovables.phone1', 'like', "%" . $search . "%")
                             ->orWhere('immovables.phone2', 'like', "%" . $search . "%")
                             ->orWhere('immovables.phone3', 'like', "%" . $search . "%")
                             ->orWhere('immovables.description', 'like', "%" . $search . "%");
                });
            }
        }

        $results = $query->get();

        return view('your.view', ['immovables' => $results]);
    }
}

登录后复制

代码解释：

Immovable::query()->leftJoin(...): 初始化 Eloquent 查询构建器，并执行必要的表联接（例如 streets 表）。
if ($request->has('search') && !empty($request->search['value'])): 确保只有在搜索参数存在且不为空时才应用搜索逻辑。
$searches = explode(" ", $request->search['value']): 使用 explode() 函数将搜索值按空格拆分为一个数组。
foreach ($searches as $index => $search): 遍历每个拆分出的关键词。
$query->orWhere(function ($subQuery) use ($search, $index) { ... });: 这是实现多关键词 OR 逻辑的关键。
- 外部的 orWhere 方法将每个关键词的所有匹配条件包裹在一个独立的分组中，例如 (条件1 或条件2 或 ...) OR (条件A 或条件B 或 ...)。
- function ($subQuery) use ($search, $index) 允许我们在一个闭包中构建针对当前关键词的所有 OR 条件。
- 在闭包内部，$subQuery->where('streets.name', 'like', "%" . $search . "%") 负责开始当前关键词的条件链，后续所有字段都通过 orWhere 连接。这样，对于每个关键词，它会在所有指定的字段中查找匹配项。

注意事项

查询性能： 当搜索字段数量众多且数据量庞大时，大量的 LIKE '%value%' 和 OR 条件可能会导致查询性能下降。
- 索引优化： 确保所有参与搜索的数据库字段都建立了合适的索引（例如 B-tree 索引）。
- 全文搜索： 对于更复杂的文本搜索需求，可以考虑使用数据库自带的全文搜索功能（如 MySQL 的 FULLTEXT 索引、PostgreSQL 的 tsvector 和 tsquery）或专业的搜索服务（如 Elasticsearch、Algolia），它们通常提供更高效和强大的文本匹配能力。
搜索精度与召回率： 拆分关键词并使用 OR 逻辑会增加召回率（找到更多相关结果），但可能会降低精度（返回一些不那么相关的结果）。根据业务需求，可能需要平衡这两者。
- 例如，可以考虑提供“精确匹配”选项，或者结合 AND 和 OR 逻辑。
关键词分隔符： 本示例使用空格作为唯一分隔符。如果用户可能使用逗号、分号或其他符号分隔关键词，您需要调整 explode() 函数的逻辑，或者在拆分前进行预处理。
输入清理： 虽然 Laravel Eloquent 默认提供了 SQL 注入保护，但对用户输入进行 trim() 处理以移除多余空格，或使用 preg_split() 配合正则表达式处理多个空格等，可以使搜索逻辑更健壮。
查询分组： 上述示例通过 orWhere(function($subQuery) { ... }) 很好地处理了每个关键词的 OR 条件分组。这等同于 SQL 中的 (condition1 OR condition2) OR (condition3 OR condition4)，确保了逻辑的正确性。

总结

通过将用户输入的搜索字符串拆分成独立关键词，并利用 Laravel Eloquent 的 orWhere 结合闭包进行动态条件构建，我们能够有效地解决传统搜索在处理多词查询时的局限性。这种优化策略显著提升了搜索的灵活性和准确性，为用户提供了更智能、更符合预期的搜索体验。在实际应用中，请务必结合数据量、查询性能和业务需求，考虑进一步的索引优化或引入专业的全文搜索解决方案。

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