如何在Twig模板的WordPress短代码中使用Twig变量？

这个问题我之前在项目里踩过坑，核心原因是Twig模板渲染和WordPress短代码解析的执行顺序冲突：WordPress会优先处理短代码语法，此时Twig的变量还没被替换成实际值，导致短代码拿到的是{{twig-variable}}这串原始文本，而非你期望的变量值。下面给你几个实用的解决办法：

方案1：将WordPress的do_shortcode注册为Twig函数（推荐） #

这是最灵活的方式，让Twig先解析变量，再调用WordPress的短代码处理逻辑。

步骤1：在主题的functions.php中注册函数 #

如果你用的是Timber（最流行的WordPress+Twig集成库），添加这段代码：

add_filter('timber/twig', function($twig) {
    // 将WordPress的do_shortcode函数暴露给Twig
    $twig->addFunction(new Timber\Twig_Function('do_shortcode', 'do_shortcode'));
    return $twig;
});

如果是你自己手动集成Twig，注册逻辑类似：

// 假设你已经初始化了Twig环境
$twig = new Twig\Environment($loader);
$twig->addFunction(new Twig\TwigFunction('do_shortcode', 'do_shortcode'));

步骤2：在Twig模板中使用 #

用Twig的字符串拼接语法~把变量嵌入短代码，再传给do_shortcode函数：

{{ do_shortcode('[wordpressshortcode name="' ~ twig_variable ~ '"]') }}

这样Twig会先把twig_variable替换成实际值，再让WordPress处理完整的短代码，变量就能正常生效了。

方案2：在PHP层提前拼接短代码 #

如果不想修改Twig的函数注册，也可以在PHP里先把变量和短代码拼接好，再传给Twig模板渲染：

// 在主题模板文件（如single.php）中
$twig_variable = get_post_meta(get_the_ID(), 'your_meta_key', true); // 示例变量来源
// 务必转义变量，避免引号冲突或XSS风险
$safe_variable = esc_attr($twig_variable);
// 提前生成短代码输出
$context['shortcode_content'] = do_shortcode('[wordpressshortcode name="' . $safe_variable . '"]');

// 将context传给Twig渲染（以Timber为例）
Timber::render('your-template.twig', $context);

然后在Twig模板中直接输出：

{{ shortcode_content }}

关键注意事项 #

• 变量转义：如果变量包含引号、特殊字符，一定要用esc_attr()（PHP层）或|escape('html_attr')（Twig层）处理，避免短代码语法出错或XSS漏洞。比如Twig里可以这么写：

  {{ do_shortcode('[wordpressshortcode name="' ~ twig_variable|escape('html_attr') ~ '"]') }}
  

• 执行顺序：无论哪种方案，核心都是确保Twig变量先被解析，再交给WordPress处理短代码，这是解决问题的核心逻辑。

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