如何阻止WordPress Bedrock不必要转义博客标题特殊字符

问题核心：在WordPress Bedrock的Blade模板中，标题里带空格的短横线（如"- title"）会被自动转成长破折号，无空格的"-title"则正常显示。需要全局阻止非用户输入内容的此类转义，拒绝单个场景用html_entity_decode临时修复的方案。

以下是几种全局解决方案：

1. 禁用/细粒度控制WordPress的wptexturize转换 #

WordPress自带的wptexturize函数是导致短横线转破折号的核心原因，它负责文本的“美化”转换（包括引号、短横线等）。

全局禁用（适合所有非用户输入内容不需要转换的场景） #

在主题的functions.php或Bedrock的mu-plugins目录下添加代码：

// 移除文章内容、摘要的wptexturize过滤
remove_filter('the_content', 'wptexturize');
remove_filter('the_excerpt', 'wptexturize');
// 移除自定义字段的wptexturize过滤（如果数据来自自定义字段）
remove_filter('get_post_metadata', 'wptexturize');

细粒度控制（保留用户输入内容的转换，仅针对特定内容禁用） #

如果需要保留文章内容的正常转换，只针对$slides_links这类非用户输入内容禁用，可以添加条件过滤：

add_filter('wptexturize', function($text, $context) {
    // 根据实际场景判断上下文，比如标记非用户输入内容的专属标识
    if (isset($context) && $context === 'custom_non_user_content') {
        return $text; // 直接返回原文本，不做转换
    }
    return wptexturize($text); // 其他内容正常转换
}, 10, 2);

在传递数据到模板前，给标题设置上下文：

$slides_links = array_map(function($link) {
    // 调用wptexturize时传入自定义上下文
    $link['title'] = apply_filters('wptexturize', $link['title'], 'custom_non_user_content');
    return $link;
}, $slides_links);

2. 自定义Blade指令统一处理非转义文本 #

创建一个自定义Blade指令，专门用于输出不需要wptexturize处理的内容，避免每次写模板都要重复处理。

在Bedrock的app/Providers/AppServiceProvider.php的boot方法中添加：

use Illuminate\Support\Facades\Blade;

public function boot()
{
    Blade::directive('rawtext', function ($expression) {
        return "<?php echo remove_wptexturize($expression); ?>";
    });
}

然后在主题的functions.php中添加辅助函数：

function remove_wptexturize($text) {
    // 临时移除所有wptexturize过滤
    $original_filters = $GLOBALS['wp_filter']['wptexturize'] ?? [];
    remove_all_filters('wptexturize');
    
    // 直接返回原文本，不经过转换
    $result = $text;
    
    // 恢复原有的过滤规则
    foreach ($original_filters as $priority => $callbacks) {
        foreach ($callbacks as $callback) {
            add_filter('wptexturize', $callback['function'], $priority, $callback['accepted_args']);
        }
    }
    
    return $result;
}

之后在模板中直接使用@rawtext指令输出：

@foreach($slides_links as $link)
    <a href="{{ $link['link'] }}" title="@rawtext($link['title'])">
        <div class="group mb-6 border-b border-red-200 pb-6 flex flex-row hover:text-red-100">
            <div class="flex flex-col flex-1">
                <h3 class="text-lg">@rawtext($link['title'])</h3>
                <p>@rawtext($link['description'])</p>
            </div>
            <div class="flex items-center">
                <p class="rounded-button flex group-hover:bg-red-100">&rarr;</p>
            </div>
        </div>
    </a>
@endforeach

3. 提前处理数据来源 #

如果$slides_links是从配置文件、自定义设置或API获取的非用户输入数据，可以在获取数据的环节直接处理，避免传递到模板后被转换：

// 假设从配置文件读取数据
$slides_links = config('slides.links');

// 批量处理标题，移除wptexturize影响
$slides_links = array_map(function($link) {
    $link['title'] = remove_wptexturize($link['title']);
    $link['description'] = remove_wptexturize($link['description']);
    return $link;
}, $slides_links);

处理后模板中直接用{{ }}输出即可，无需额外操作。

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