本文旨在指导开发者如何在Laravel应用中，利用MySQL的强大功能，实现对包含连字符或空格的字符串进行灵活且大小写不敏感的模糊搜索。核心策略是巧妙运用MySQL的`_`（下划线）通配符，将用户搜索词中的空格和连字符统一替换为`_`，从而在数据库中匹配到相应的字段，避免了复杂的数据库函数操作，提高了查询效率和代码可读性。
背景与问题描述
在开发Web应用时，我们经常会遇到需要搜索数据库中特定字段的需求。例如，产品名称可能存储为product-example，而用户在搜索时可能会输入product example（用空格代替连字符）或者直接输入product-example。我们期望无论用户如何输入，都能找到正确的结果，并且搜索过程应该是不区分大小写的。
常见的错误尝试可能包括在WHERE子句中直接使用REPLACE()或UPPER()等MySQL函数来处理数据库字段，例如：
// 错误的尝试示例，可能导致语法错误或性能问题
$products = Product::whereRaw(
"UPPER(REPLACE(name, '-', ' ')) LIKE '%".str_replace('-', ' ', $search)."%'"
)->get();这种做法不仅可能因语法错误而失败（如上述用户案例），而且在大型数据集中对每一行进行函数操作会严重影响查询性能，因为它通常会阻止索引的使用。
MySQL LIKE 操作符与通配符
要实现灵活的模糊搜索，我们需要理解MySQL的LIKE操作符及其通配符：
- 大小写不敏感： MySQL的LIKE操作符在大多数默认的字符集和排序规则（如utf8_general_ci、utf8mb4_unicode_ci）下是默认大小写不敏感的。这意味着，除非明确指定了大小写敏感的排序规则，否则LIKE 'product'会匹配Product、product、PRODUCT等。因此，通常不需要额外使用UPPER()函数来处理大小写。
- % 通配符： 匹配任意数量的任意字符（包括零个字符）。例如，%example%会匹配包含example的所有字符串。
- _ 通配符： 匹配任意单个字符。这是解决连字符和空格问题的关键。
优化方案：利用 _ 通配符
解决上述问题的核心思想是：不修改数据库中的字段值，而是修改用户的搜索词。我们可以将用户搜索词中的所有空格和连字符都替换为MySQL的_通配符。这样，_就能同时匹配数据库字段中的空格或连字符。
实现步骤：
- 获取用户输入的搜索词。
- 将搜索词中的所有空格和连字符替换为_通配符。
- 将处理后的搜索词与%通配符结合，用于LIKE查询。
Laravel Eloquent 代码示例：
input('q'); // 获取用户搜索关键词
if (empty($search)) {
return response()->json(['products' => []]);
}
// 核心逻辑：将搜索词中的空格和连字符都替换为 '_' 通配符
// 例如：
// 'product example' -> 'product_example'
// 'product-example' -> 'product_example'
// 'my product-test' -> 'my_product_test'
$searchTermPrepared = str_replace([' ', '-'], '_', $search);
// 使用 Laravel Eloquent 的 where('column', 'like', '%term%') 进行查询
// MySQL 默认对 LIKE 操作是大小写不敏感的
$products = Product::where('name', 'like', '%' . $searchTermPrepared . '%')
->get();
return response()->json(['products' => $products]);
}
}工作原理分析：
假设数据库中有一个产品名称为 product-example。 如果用户搜索 product example：
- str_replace([' ', '-'], '_', 'product example') 结果为 product_example。
- 查询变为 WHERE name LIKE '%product_example%'。
- product_example 中的 _ 可以匹配 product-example 中的 -，所以该产品会被找到。
如果用户搜索 product-example：
- str_replace([' ', '-'], '_', 'product-example') 结果为 product_example。
- 查询变为 WHERE name LIKE '%product_example%'。
- product_example 中的 _ 可以匹配 product-example 中的 -，所以该产品也会被找到。
注意事项与最佳实践
-
MySQL 排序规则（Collation）： 确保你的数据库表或字段使用了大小写不敏感的排序规则（例如 utf8mb4_unicode_ci 或 utf8_general_ci）。如果使用了大小写敏感的排序规则（如 utf8mb4_bin），则需要显式使用 LOWER() 或 UPPER() 函数来统一大小写，但这会牺牲索引性能。
// 如果必须处理大小写敏感的 collation，且性能允许 $products = Product::whereRaw('LOWER(name) LIKE ?', ['%' . strtolower($searchTermPrepared) . '%']) ->get(); -
性能考虑： LIKE '%term%' 这种前缀和后缀都带 % 的模糊查询，通常无法有效利用字段索引，尤其是在大型数据集中可能会导致全表扫描，影响性能。
- 优化建议： 如果搜索需求非常频繁且数据量巨大，可以考虑使用全文搜索（Full-Text Search）解决方案，如 MySQL 的内置全文索引、Elasticsearch 或 Algolia 等专业搜索服务。
- 如果只需匹配前缀，如 LIKE 'term%'，索引可以被有效利用。
-
通配符转义： 如果你的搜索词本身可能包含 _ 或 % 字符，并且你希望它们被当作普通字符而不是通配符来匹配，你需要对它们进行转义。MySQL 的默认转义字符是 \。
// 假设用户搜索词可能包含 '_' 或 '%' $search = $request->input('q'); $search = str_replace(['\\', '_', '%'], ['\\\\', '\_', '\%'], $search); // 先转义转义字符本身，再转义通配符 $searchTermPrepared = str_replace([' ', '-'], '_', $search); // 替换空格和连字符为 '_' $products = Product::where('name', 'like', '%' . $searchTermPrepared . '%') ->get();在Laravel中，where() 方法通常会自动处理简单的转义，但对于复杂的通配符转义，手动处理更安全。
用户体验： 考虑为用户提供搜索提示或建议，以提高搜索的准确性和用户体验。
总结
通过巧妙地将用户搜索词中的空格和连字符替换为MySQL的_通配符，我们可以在Laravel中实现一个既灵活又高效的模糊搜索功能，能够同时匹配包含连字符或空格的数据库字段。这种方法避免了在WHERE子句中对数据库字段进行函数操作，从而保持了查询的简洁性和性能。在实际应用中，还需要结合数据库的排序规则、性能需求以及用户体验进行综合考虑。
