本文旨在解决 laravel 8 中使用 eloquent orm 进行多词模糊搜索时遇到的挑战，特别是当搜索词包含多个单词（如姓名和姓氏）时无法正确匹配的问题。通过介绍一种将搜索短语分词并结合 `orwhere` 语句进行动态查询的策略，实现更灵活、准确的数据库搜索功能。
理解多词搜索的挑战
在 Laravel 中，当我们需要在多个数据库字段中执行模糊搜索时，通常会使用 where 或 orWhere 结合 LIKE 操作符。例如，以下代码片段展示了在多个字段中搜索单个关键词的常见做法：
$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')) {
$searchTerm = "%" . request()->search['value'] . "%";
$query->where('streets.name', 'like', $searchTerm)
->orWhere('immovables.community', 'like', $searchTerm)
// ... 其他 orWhere 条件
->orWhere('immovables.name', 'like', $searchTerm)
->orWhere('immovables.surname', 'like', $searchTerm);
}
$results = $query->get();这种方法对于单个单词的搜索（例如，搜索 "Karol" 或 "Krawczyk"）是有效的。然而，当用户输入包含多个单词的搜索短语（例如 "Karol Krawczyk"）时，上述代码会将其作为一个整体进行匹配。这意味着数据库将尝试查找一个字段中同时包含 "Karol Krawczyk" 整个字符串的记录。如果 "Karol" 在 immovables.name 字段，而 "Krawczyk" 在 immovables.surname 字段，或者它们分散在不同的字段中，那么这种整体匹配的方式将无法返回任何结果，从而导致搜索失败。
要解决这个问题，我们需要将用户输入的搜索短语拆分成独立的单词，并对每个单词在所有目标字段中执行独立的模糊匹配。
解决方案：分词与动态查询
为了实现更灵活的多词搜索，我们可以采取以下策略：
- 分词处理： 将用户输入的搜索短语（例如 "Karol Krawczyk"）按照空格或其他分隔符拆分成独立的单词（"Karol", "Krawczyk"）。
- 动态构建查询： 遍历这些拆分后的单词，对每个单词在所有需要搜索的字段中应用 LIKE 操作符。关键在于，对于每个单词，我们都使用 orWhere 来连接其在不同字段上的匹配条件。
示例代码
以下是优化后的 Laravel 查询代码，它演示了如何实现上述策略：
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'])) {
// 将搜索值按空格拆分成多个单词
$searches = explode(" ", $request->search['value']);
// 使用一个闭包来分组所有的 OR 条件，确保逻辑清晰
$query->where(function ($q) use ($searches) {
foreach ($searches as $search) {
$searchTerm = "%" . $search . "%"; // 为每个单词构建模糊匹配字符串
// 对每个单词在所有相关字段中执行 OR 匹配
$q->orWhere('streets.name', 'like', $searchTerm);
$q->orWhere('immovables.community', 'like', $searchTerm);
$q->orWhere('immovables.city', 'like', $searchTerm);
$q->orWhere('immovables.building_number', 'like', $searchTerm);
$q->orWhere('immovables.granted_comments', 'like', $searchTerm);
$q->orWhere('immovables.inspections', 'like', $searchTerm);
$q->orWhere('immovables.oze_installations', 'like', $searchTerm);
$q->orWhere('immovables.pesel', 'like', $searchTerm);
$q->orWhere('immovables.name', 'like', $searchTerm);
$q->orWhere('immovables.surname', 'like', $searchTerm);
$q->orWhere('immovables.email1', 'like', $searchTerm);
$q->orWhere('immovables.email2', 'like', $searchTerm);
$q->orWhere('immovables.email3', 'like', $searchTerm);
$q->orWhere('immovables.phone1', 'like', $searchTerm);
$q->orWhere('immovables.phone2', 'like', $searchTerm);
$q->orWhere('immovables.phone3', 'like', $searchTerm);
$q->orWhere('immovables.description', 'like', $searchTerm);
}
});
}
$results = $query->get();
return view('your.view', compact('results')); // 假设您将结果传递给视图
}
}代码解析
- explode(" ", $request->search['value']): 这行代码将用户输入的搜索字符串 $request->search['value'] 按照空格进行分割，生成一个包含所有独立单词的数组 $searches。例如，"Karol Krawczyk" 将变为 ['Karol', 'Krawczyk']。
- $query->where(function ($q) use ($searches) { ... }): 这是一个关键的优化。通过使用 where 闭包，我们将所有针对搜索词的 OR 条件封装在一个独立的逻辑组中。这在 SQL 中通常会生成类似 WHERE (condition1 OR condition2 OR ...) 的语句，确保了搜索逻辑的正确优先级，避免与其他潜在的 AND 条件发生冲突。
- foreach ($searches as $search): 循环遍历每个拆分后的单词。
- $searchTerm = "%" . $search . "%": 为当前循环的单词构建一个 LIKE 匹配字符串，例如 "%Karol%"。
-
$q->orWhere('column_name', 'like', $searchTerm): 对于每个单词 $search，我们遍历所有需要搜索的字段，并使用 orWhere 将它们连接起来。这意味着只要任何一个字段包含当前单词，该记录就会被匹配。
- 例如，如果搜索词是 "Karol Krawczyk"，循环将首先处理 "Karol"。此时，查询会添加一系列 orWhere 条件，查找任何字段中包含 "Karol" 的记录。
- 接着，循环处理 "Krawczyk"。此时，又会添加一系列 orWhere 条件，查找任何字段中包含 "Krawczyk" 的记录。
- 最终生成的 SQL 查询将是一个大的 OR 逻辑块，例如： WHERE ( (streets.name LIKE '%Karol%' OR immovables.community LIKE '%Karol%' OR ... OR immovables.surname LIKE '%Karol%') OR (streets.name LIKE '%Krawczyk%' OR immovables.community LIKE '%Krawczyk%' OR ... OR immovables.surname LIKE '%Krawczyk%') )
- 这样，无论 "Karol" 和 "Krawczyk" 出现在哪个字段，或者是否同时出现，只要满足任一条件，记录都会被检索出来。
注意事项
- 性能考量： 这种方法在搜索字段较多且数据量庞大时，可能会导致性能下降。因为 LIKE %...% 操作符通常无法有效利用索引，尤其是前导通配符 (%)。
-
搜索词清理： 在实际应用中，建议对用户输入的搜索词进行额外的清理，例如：
- trim()：去除首尾空格。
- mb_strtolower()：转换为小写（如果搜索不区分大小写）。
- 去除多余的空格（例如，将 "Karol Krawczyk" 变为 "Karol Krawczyk"）。
- 用户体验： 结合前端技术，可以提供搜索建议、实时搜索、搜索结果高亮等功能，进一步提升用户体验。
- SQL 注入： Laravel Eloquent ORM 已经内置了对 SQL 注入的防护，通过参数绑定来处理所有用户输入。因此，只要您通过 Eloquent 的方法构建查询，就无需担心 SQL 注入问题。
总结
通过将用户输入的搜索短语进行分词，并结合 Laravel Eloquent 的 orWhere 闭包和循环结构，我们可以有效地实现多词模糊搜索功能。这种方法解决了单一 LIKE 匹配无法处理多单词搜索的局限性，使得搜索结果更加灵活和符合用户预期。然而，对于大规模应用，仍需权衡性能，并考虑引入更专业的全文搜索解决方案。
