本教程探讨了在 Laravel 8 中进行多字段模糊搜索时，如何有效处理包含空格的复合查询字符串。通过将搜索值拆分为多个关键词并循环应用 `orWhere` 条件，解决了传统 `orWhere` 链无法匹配姓名等复合字段的问题，显著提升了搜索的灵活性和准确性。
引言：Laravel 多字段搜索的挑战
在 Laravel 应用程序中，数据库搜索是常见的功能需求。利用 Eloquent ORM 和查询构建器，开发者可以轻松地构建复杂的数据库查询。然而，当用户需要在一个搜索框中输入包含多个词语（例如“名 姓”）的复合查询，并且这些词语可能分散在数据库的不同字段（如 name 和 surname）时，传统的 orWhere 链式查询可能会遇到问题。
考虑以下场景：用户希望搜索名为“Karol Krawczyk”的记录。如果数据库中存在 name 字段为“Karol”且 surname 字段为“Krawczyk”的记录，但使用单个搜索字符串“Karol Krawczyk”进行查询时，却无法得到结果。这是因为默认的 LIKE 查询会将整个字符串作为一个整体进行匹配，例如 immovables.name LIKE "%Karol Krawczyk%"，这显然无法匹配到 name 字段只有“Karol”的情况。
以下是原始的查询代码示例，它展示了对单个搜索值应用多个 orWhere 条件的常见模式：
$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')) { // 假设 $request->search['value'] 为 "Karol Krawczyk" $searchValue = $request->search['value']; $query->where('streets.name', 'like', "%" . $searchValue . "%"); $query->orWhere('immovables.community', 'like', "%" . $searchValue . "%"); // ... 其他字段 $query->orWhere('immovables.name', 'like', "%" . $searchValue . "%"); // 匹配 "%Karol Krawczyk%" $query->orWhere('immovables.surname', 'like', "%" . $searchValue . "%"); // 匹配 "%Karol Krawczyk%" // ... 更多字段}$query->get();登录后复制这段代码能够正常工作，但当 $searchValue 包含空格时，它会将整个字符串作为单个匹配模式，导致无法找到分散在不同字段中的独立词语。
问题分析：复合搜索词的匹配困境
当用户输入“Karol Krawczyk”时，上述代码会生成类似 WHERe immovables.name LIKE "%Karol Krawczyk%" 或 OR immovables.surname LIKE "%Karol Krawczyk%" 的 SQL 条件。如果数据库中 immovables.name 字段的值是“Karol”，immovables.surname 字段的值是“Krawczyk”，那么这些条件都不会匹配成功，因为没有一个字段完整包含“Karol Krawczyk”这个字符串。
要解决这个问题，我们需要将用户输入的复合搜索词拆分成独立的关键词，并对每个关键词分别应用多字段的 OR 搜索逻辑。这样，无论是“Karol”匹配 name 字段还是“Krawczyk”匹配 surname 字段，都能被正确检索到。
解决方案：拆分关键词与条件循环构建
核心思想是：将用户输入的搜索字符串按空格拆分成多个独立的关键词。然后，遍历这些关键词，为每个关键词构建一组 OR 条件，应用到所有需要搜索的字段上。最终，所有关键词的所有搜索条件将通过 OR 逻辑连接起来。
具体步骤如下：
腾讯云AI代码助手 基于混元代码大模型的AI辅助编码工具
172 查看详情 
获取用户输入的搜索值。使用 explode() 函数将搜索值按空格拆分成一个关键词数组。遍历关键词数组。在循环内部，为当前关键词构建一组 OR 条件，覆盖所有目标字段。为了确保查询逻辑的正确性，第一个关键词的第一个条件应使用 where()，而后续的所有条件（包括同一关键词的其他字段以及所有后续关键词的所有字段）都使用 orWhere()。代码实现与解析
以下是优化后的 Laravel 查询代码示例：
use Illuminate\Http\Request; // 确保引入 Request 类// 假设这段代码在一个控制器方法中public function searchImmovables(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'])) { $searches = explode(" ", $request->search['value']); // 拆分搜索值 foreach ($searches as $index => $search) { // 对每个关键词进行处理，确保去除空白字符 $search = trim($search); if (empty($search)) { continue; // 跳过空关键词 } // 构建条件组： // 对于第一个关键词，其第一个字段使用 where()，后续字段使用 orWhere() // 对于后续关键词，所有字段都使用 orWhere() if ($index === 0) { // 第一个关键词的第一个条件使用 WHERe $query->where('streets.name', 'like', "%" . $search . "%"); } else { // 后续关键词的第一个条件以及所有后续条件使用 OR WHERe $query->orWhere('streets.name', 'like', "%" . $search . "%"); } // 对所有其他字段应用 OR WHERe 条件 $query->orWhere('immovables.community', 'like', "%" . $search . "%"); $query->orWhere('immovables.city', 'like', "%" . $search . "%"); $query->orWhere('immovables.building_number', 'like', "%" . $search . "%"); $query->orWhere('immovables.granted_comments', 'like', "%" . $search . "%"); $query->orWhere('immovables.inspections', 'like', "%" . $search . "%"); $query->orWhere('immovables.oze_installations', 'like', "%" . $search . "%"); $query->orWhere('immovables.pesel', 'like', "%" . $search . "%"); $query->orWhere('immovables.name', 'like', "%" . $search . "%"); $query->orWhere('immovables.surname', 'like', "%" . $search . "%"); $query->orWhere('immovables.email1', 'like', "%" . $search . "%"); $query->orWhere('immovables.email2', 'like', "%" . $search . "%"); $query->orWhere('immovables.email3', 'like', "%" . $search . "%"); $query->orWhere('immovables.phone1', 'like', "%" . $search . "%"); $query->orWhere('immovables.phone2', 'like', "%" . $search . "%"); $query->orWhere('immovables.phone3', 'like', "%" . $search . "%"); $query->orWhere('immovables.description', 'like', "%" . $search . "%"); } } $results = $query->get(); return response()->json($results);}登录后复制代码解析：
explode(" ", $request->search['value']): 这行代码将用户输入的搜索字符串（例如“Karol Krawczyk”）按空格分割成一个数组 ["Karol", "Krawczyk"]。foreach ($searches as $index => $search): 循环遍历每个拆分出来的关键词。$search = trim($search); if (empty($search)) { continue; }: 这一步是数据清理，确保处理用户可能输入多个空格的情况，避免产生空的搜索关键词。if ($index === 0) { ... } else { ... }: 这是关键逻辑。当 $index 为 0 时（即处理第一个关键词“Karol”），$query->where('streets.name', 'like', "%" . $search . "%") 会作为整个查询的第一个 WHERe 条件。当 $index 大于 0 时（即处理第二个关键词“Krawczyk”及以后），$query->orWhere('streets.name', 'like', "%" . $search . "%") 会将此条件通过 OR 逻辑连接到之前的所有条件上。$query->orWhere('immovables.community', 'like', "%" . $search . "%"); 等后续 orWhere 调用: 在每次循环中，无论当前是第几个关键词，这些 orWhere 条件都会将当前关键词的匹配逻辑应用到对应的字段上，并通过 OR 逻辑与之前的所有条件（包括当前关键词的第一个条件以及之前所有关键词的所有条件）连接起来。通过这种方式，如果用户搜索“Karol Krawczyk”，最终的 SQL 查询逻辑大致会是：(streets.name LIKE '%Karol%' OR immovables.community LIKE '%Karol%' OR ... OR immovables.name LIKE '%Karol%' OR immovables.surname LIKE '%Karol%') OR (streets.name LIKE '%Krawczyk%' OR immovables.community LIKE '%Krawczyk%' OR ... OR immovables.name LIKE '%Krawczyk%' OR immovables.surname LIKE '%Krawczyk%')
这样，只要“Karol”在任何一个指定字段中找到，或者“Krawczyk”在任何一个指定字段中找到，该记录都会被返回，从而解决了复合搜索词的匹配问题。
注意事项
查询性能：当搜索字段数量众多且数据量庞大时，大量的 OR 条件可能会导致查询性能下降。确保所有参与搜索的数据库字段都建立了合适的索引（尤其是 LIKE 查询常用的 B-tree 索引或全文索引，具体取决于数据库类型和查询模式）。
SQL 逻辑分组：上述解决方案将所有条件简单地通过 OR 连接。如果需要更精细的逻辑分组，例如“（关键词A在字段X或字段Y中）AND（关键词B在字段X或字段Y中）”，则需要使用 Eloquent 的闭包 where(function($query){ ... }) 来嵌套和分组条件。例如，要实现 (field1 LIKE %Karol% OR field2 LIKE %Karol%) AND (field1 LIKE %Krawczyk% OR field2 LIKE %Krawczyk%) 这种逻辑，代码会更复杂：
if ($request->has('search') && !empty($request->search['value'])) { $searches = explode(" ", $request->search['value']); foreach ($searches as $search) { $search = trim($search); if (empty($search)) continue; $query->where(function ($subQuery) use ($search) { $subQuery->where('streets.name', 'like', "%" . $search . "%") ->orWhere('immovables.community', 'like', "%" . $search . "%") // ... 其他字段 ->orWhere('immovables.name', 'like', "%" . $search . "%") ->orWhere('immovables.surname', 'like', "%" . $search . "%"); }); }}登录后复制这种方式会生成 (cond_for_Karol) AND (cond_for_Krawczyk) 的逻辑。然而，对于本教程解决的“Karol Krawczyk”问题，原始的 OR 逻辑通常更符合预期，因为它意味着只要找到任何一个词的任何一个匹配即可。
用户体验：可以考虑对用户输入的搜索词进行预处理，例如转换为小写（如果数据库不区分大小写或使用不区分大小写的排序规则）、去除多余空格、甚至支持同义词替换等，以提升搜索的准确性和用户体验。
全文搜索：对于更高级的文本搜索需求，例如词干提取、相关性排序等，可以考虑使用数据库自带的全文搜索功能（如 MySQL 的 FULLTEXT 索引、PostgreSQL 的 tsvector 和 tsquery）或集成专门的搜索服务（如 Elasticsearch、Algolia）。
总结
通过将复合搜索字符串拆分为独立的关键词，并对每个关键词应用多字段的 OR 条件，我们成功地解决了 Laravel 中多字段模糊搜索无法匹配包含空格的复合查询的问题。这种方法提高了搜索的灵活性和准确性，使得用户能够更自然地进行搜索。在实际应用中，开发者应根据具体需求权衡查询性能和功能复杂度，并考虑使用索引优化和更高级的搜索技术。
以上就是Laravel 8 多字段模糊搜索优化：处理包含空格的复合查询的详细内容，更多请关注php中文网其它相关文章！
