WordPress搜索忽略撇号问题：含撇号内容无法匹配求助

这个问题我之前也碰到过，WordPress默认的搜索逻辑对带特殊字符（比如撇号）的处理确实有点坑，而且要实现dont和don't互通搜索也需要自定义一下搜索规则。咱们一步步来解决：

1. 为什么搜索don't无结果？ #

默认情况下，WP_Query的s参数会对搜索词进行转义，而且WordPress的全文搜索会把撇号当作词的分隔符，导致don't被拆成don和t来搜索，自然匹配不到完整包含don't的内容。另外，MySQL的全文索引在处理撇号时也可能会忽略它，或者把它当作停用词的一部分，进一步导致匹配失败。

2. 解决方案：自定义搜索逻辑 #

我们可以通过posts_search过滤器修改WP_Query生成的搜索SQL，同时预处理搜索词，让它既能匹配带撇号的内容，也能匹配不带撇号的变体。

步骤1：预处理搜索词，生成匹配变体 #

先对传入的搜索值进行处理，覆盖带撇号和不带撇号的两种情况：

$searchValue = $request->get_param("s");
// 生成需要匹配的搜索词变体
$searchVariants = [];
// 原始搜索词
$searchVariants[] = $searchValue;
// 去掉撇号的版本（比如把don't转成dont）
$noApostrophe = str_replace("'", "", $searchValue);
if ($noApostrophe !== $searchValue) {
    $searchVariants[] = $noApostrophe;
}
// 补充带撇号的版本（比如把dont转成don't）
$withApostrophe = preg_replace('/(\w+)t$/', '$1\'t', $noApostrophe);
if ($withApostrophe !== $noApostrophe && !in_array($withApostrophe, $searchVariants)) {
    $searchVariants[] = $withApostrophe;
}

步骤2：用posts_search过滤器修改搜索规则 #

添加过滤器，让WP_Query同时匹配所有生成的搜索变体，并且只在我们的自定义分类查询中生效，避免影响全局搜索：

add_filter('posts_search', function($search, $wpQuery) use ($searchVariants) {
    global $wpdb;
    
    // 只针对cat=9的自定义查询生效，避免干扰全局搜索
    if (!$wpQuery->is_search || empty($wpQuery->query_vars['cat']) || $wpQuery->query_vars['cat'] != 9) {
        return $search;
    }
    
    if (empty($searchVariants)) {
        return $search;
    }
    
    // 构建匹配标题或内容的条件
    $searchConditions = [];
    foreach ($searchVariants as $variant) {
        $escapedVariant = $wpdb->esc_like($variant);
        $searchConditions[] = "({$wpdb->posts}.post_title LIKE '%{$escapedVariant}%' OR {$wpdb->posts}.post_content LIKE '%{$escapedVariant}%')";
    }
    
    // 替换默认的搜索SQL语句
    $search = ' AND (' . implode(' OR ', $searchConditions) . ')';
    
    return $search;
}, 10, 2);

步骤3：执行WP_Query查询 #

现在再执行你的查询，就能同时匹配带撇号和不带撇号的内容了：

$wpQueryPosts = new \WP_Query([
    'post_type' => 'post',
    'posts_per_page' => -1,
    'cat' => 9,
    's' => $searchValue, // 这里传原始搜索值即可，过滤器会处理变体匹配
]);
$postsPosts = $wpQueryPosts->get_posts();

3. 额外优化：支持智能撇号匹配 #

如果你的内容里还有智能撇号（比如don’t），可以把预处理逻辑改成支持多种撇号格式：

// 替换所有类型的撇号为空，生成变体
$noApostrophe = preg_replace('/[\'’]/', "", $searchValue);

4. 性能说明 #

如果你的文章数量很大，LIKE查询可能会有性能问题，这种情况下可以考虑给post_title和post_content字段添加全文索引，或者用MySQL的REGEXP来替代LIKE（正则匹配更灵活但性能相近）。

内容的提问来源于stack exchange，提问作者user9876776