本文旨在解决 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 或其他字段中），并将所有符合任一条件的记录返回。
注意事项与最佳实践
-
性能考量：
- 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 方法进行分组匹配，我们能够有效解决多字段多关键词模糊搜索的难题。这种方法显著提升了搜索的灵活性和用户体验，使得用户能够通过更自然的语言进行搜索并获得准确的结果。在实际应用中，开发者应根据数据量和性能要求，权衡是否需要引入更高级的全文搜索技术。
