如何在 Twig 模板解析中保留并识别 raw 过滤器-php教程-PHP中文网

如何在 Twig 模板解析中保留并识别 raw 过滤器

默认情况下，Twig 的优化器会移除 |raw 过滤器（因其被视为无副作用的“空操作”），导致通过 AST 解析时无法捕获该节点；需显式禁用相关优化选项以确保 FilterExpression 节点完整保留。

默认情况下，twig 的优化器会移除 `|raw` 过滤器（因其被视为无副作用的“空操作”），导致通过 ast 解析时无法捕获该节点；需显式禁用相关优化选项以确保 `filterexpression` 节点完整保留。

在使用 Twig 的 parse() + tokenize() 流程分析模板 AST 时，若目标是检测或处理特定过滤器（如 |raw），开发者常遇到一个隐性陷阱：|raw 节点在默认配置下根本不会出现在最终语法树中。

这是因为 Twig 内置的 OptimizerNodeVisitor 在启用优化时（默认开启部分优化），会主动移除 raw 过滤器——其逻辑认为：raw 仅用于取消自动转义，不改变表达式值本身，在编译阶段可安全剥离，交由渲染时的上下文决定是否转义。因此，即使模板中明确写了 {{ attributes|raw|lower }}，解析出的 \Twig\Node\Expression\FilterExpression 节点链里也只会剩下 |lower，raw 已被提前消除。

✅ 正确解决方案是：禁用影响 raw 保留的优化项。推荐做法是在初始化 Twig\Environment 时，将 optimizations 配置设为 0（完全关闭优化），或至少排除 OPTIMIZE_RAW_FILTER（Twig ≥ 3.10+ 支持细粒度控制）：

use Twig\Environment;
use Twig\Loader\FilesystemLoader;
use Twig\NodeVisitor\OptimizerNodeVisitor;

$loader = new FilesystemLoader('/path/to/templates');
$options = [
    'cache' => sys_get_temp_dir(),
    'optimizations' => 0, // 关键：彻底禁用所有 AST 优化
    // 或更精准地（Twig v3.10+）：
    // 'optimizations' => OptimizerNodeVisitor::OPTIMIZE_ALL & ~OptimizerNodeVisitor::OPTIMIZE_RAW_FILTER,
];

$twig = new Environment($loader, $options);

// 后续解析流程保持不变
$source = new \Twig\Source(file_get_contents($templatePath), 'example.twig');
$tree = $twig->parse($twig->tokenize($source));

// 现在 listFunctionCalls 可正确命中 raw 过滤器
function listFunctionCalls($node, array &$list) {
    if ($node instanceof \Twig\Node\Expression\FilterExpression) {
        $filterNode = $node->getNode('filter');
        $filterName = $filterNode->getAttribute('value') ?? '';
        if ($filterName === 'raw') {
            $list[] = [
                'line' => $node->getLine(),
                'parent' => get_class($node->getNode('node')),
            ];
        }
    }
    foreach ($node as $child) {
        listFunctionCalls($child, $list);
    }
}

$functions = [];
listFunctionCalls($tree, $functions);
var_dump($functions); // 输出包含 'raw' 的匹配项

⚠️ 注意事项：