Laravel与MySQL：利用通配符实现含连字符/空格的产品名称灵活搜索-php教程-PHP中文网

Laravel与MySQL：利用通配符实现含连字符/空格的产品名称灵活搜索

霞舞

发布： 2025-11-06 11:35:00

原创

572人浏览过

Laravel与MySQL：利用通配符实现含连字符/空格的产品名称灵活搜索

本教程详细介绍了如何在laravel应用中，利用mysql的`_`通配符实现对包含连字符或空格的产品名称进行灵活且不区分大小写的搜索。通过将用户搜索词中的空格和连字符替换为`_`，可以有效匹配数据库中以这两种形式存储的产品名称，避免复杂的`replace`函数，并提供简洁高效的查询方案。

在现代Web应用中，用户经常需要通过搜索功能查找产品、文章或其他数据。一个常见场景是，产品名称可能以多种形式存储，例如“product-example”或“product example”。用户在搜索时可能输入“product example”或“product-example”，都期望能找到相同的结果。本教程将指导您如何在Laravel框架下，结合MySQL的特性，实现这种灵活且不区分大小写的搜索。

理解MySQL的LIKE操作与通配符

MySQL在执行LIKE操作时，默认情况下通常是大小写不敏感的，这取决于数据库或字段的字符集和排序规则（通常以_ci结尾的排序规则表示大小写不敏感，如utf8mb4_unicode_ci）。

除了大小写不敏感的特性，MySQL的LIKE操作还支持两种重要的通配符：

% (百分号)：匹配零个、一个或多个任意字符。例如，'pro%'将匹配所有以“pro”开头的字符串。
_ (下划线)：匹配任意单个字符。例如，'pro_uct'将匹配“product”、“pro uct”、“pro-uct”等。

利用_通配符匹配任意单个字符的特性，我们可以巧妙地解决连字符和空格的灵活匹配问题。

解决方案：使用_通配符替换搜索词中的分隔符

核心思想是将用户输入的搜索词中的潜在分隔符（如空格或连字符）替换为MySQL的_通配符。这样，无论数据库中的名称是使用空格还是连字符作为分隔符，只要它们在相应位置上只有一个字符，就可以被_通配符匹配到。

例如，如果用户搜索“product example”，我们将其转换为“product_example”。这个模式将能够匹配数据库中的“product-example”和“product example”。

Laravel实现示例

以下是在Laravel应用中实现此功能的代码示例：

use App\Models\Product; // 假设您的产品模型是 App\Models\Product
use Illuminate\Http\Request;
use Illuminate\Database\Eloquent\Collection; // 引入Collection类型提示

class ProductController extends Controller
{
    /**
     * 根据用户输入搜索产品名称。
     *
     * @param Request $request
     * @return Collection<int, Product>
     */
    public function search(Request $request): Collection
    {
        $searchTerm = $request->input('search'); // 获取用户输入的搜索词，例如 "product example" 或 "product-example"

        if (empty($searchTerm)) {
            return new Collection(); // 如果搜索词为空，返回空集合
        }

        // 1. 预处理搜索词：将空格和连字符替换为MySQL的 '_' 通配符
        // 这样，"product example" 变为 "product_example"
        // "product-example" 变为 "product_example"
        // 这个处理后的字符串可以匹配数据库中 "product-example" 或 "product example"
        $processedSearchTerm = str_replace([' ', '-'], '_', $searchTerm);

        // 2. 构建 LIKE 查询
        // 使用 Eloquent 的 where 方法，结合 'like' 操作符和 '%' 通配符
        // '%' . $processedSearchTerm . '%' 意味着匹配任何包含处理后搜索词的字符串
        $products = Product::where('name', 'like', '%' . $processedSearchTerm . '%')->get();

        return $products;
    }
}

登录后复制

代码解释：

NameGPT名称生成器

免费AI公司名称生成器，AI在线生成企业名称，注册公司名称起名大全。

查看详情

$request->input('search'): 从HTTP请求中获取用户提交的搜索词。
str_replace([' ', '-'], '_', $searchTerm): 这是实现核心逻辑的关键。它将 $searchTerm 中所有出现的空格（`）和连字符（-）都替换为单个下划线（_`）。
- 例如，如果$searchTerm是"product example"，$processedSearchTerm将变为"product_example"。
- 如果$searchTerm是"product-example"，$processedSearchTerm也将变为"product_example"。
Product::where('name', 'like', '%' . $processedSearchTerm . '%')->get():
- where('name', 'like', ...)：使用Eloquent构建一个WHERE name LIKE ...的SQL子句。
- '%' . $processedSearchTerm . '%'：构建最终的LIKE模式。两端的%通配符表示匹配任何位置包含$processedSearchTerm的字符串。

通过这种方法，当数据库中存在name为product-example和product example的产品时，用户无论搜索product example还是product-example，都能有效地找到这两个产品。

注意事项与最佳实践

MySQL Collation（排序规则）: 确保您的MySQL数据库、表或特定列的排序规则是大小写不敏感的（例如，utf8mb4_unicode_ci）。如果使用的是大小写敏感的排序规则（例如，utf8mb4_bin），则需要额外使用LOWER()或UPPER()函数来强制大小写不敏感，但这会增加查询的复杂性和性能开销。对于大多数Web应用场景，默认的_ci排序规则是合适的。
性能考量:
- LIKE查询，特别是当模式以%开头时（例如%term%），通常无法有效利用常规的B-tree索引，可能导致全表扫描，从而影响大型数据集的查询性能。
- 对于非常大的数据集和复杂的搜索需求，可以考虑使用专门的全文搜索解决方案，如MySQL的FULLTEXT索引、Elasticsearch、Solr等。这些工具能提供更高级的搜索功能和更好的性能。
- 对于中小型数据集或搜索频率不高的场景，上述LIKE结合通配符的方法通常是可接受的。
安全性: Laravel的Eloquent ORM在执行where查询时会自动进行参数绑定，这可以有效防止SQL注入攻击。即使我们手动拼接了LIKE模式，由于$processedSearchTerm是经过str_replace处理后的用户输入，并且最终通过参数绑定传递给数据库，因此安全性较高。
通配符的精确性: _通配符匹配“任意单个字符”。这意味着如果您的产品名称可能包含多个连字符（如product--example）而用户只搜索product-example，那么product_example将无法匹配product--example。如果需要匹配可变数量的任意字符，您可能需要考虑更复杂的正则表达式匹配（如果数据库支持）或多次替换。然而，对于本教程描述的“一个空格或一个连字符”的常见场景，_通配符是完美且简洁的解决方案。

总结

通过巧妙地利用MySQL的_通配符，我们可以在Laravel应用中实现对包含连字符或空格的产品名称进行灵活且不区分大小写的搜索。这种方法简洁高效，避免了在whereRaw中使用复杂的REPLACE函数可能导致的语法错误和性能问题。在实际开发中，理解数据库的特性并结合框架提供的便利，可以构建出既强大又易于维护的应用功能。

以上就是Laravel与MySQL：利用通配符实现含连字符/空格的产品名称灵活搜索的详细内容，更多请关注php中文网其它相关文章！