php - 扩展 Symfony 以自动转义 .tex.twig 文件的 latex 字符

Question

我正在使用.tex.twig文件来在我的项目中生成一些 PDF。默认情况下，我的所有 twig 文件都会使用 html 自动转义。战略。为了阻止意外的逃逸，我不得不包裹我所有的 .tex.twig autoescape false 中的文件 block 。
我想保留默认html逃离 .html.twig文件，但在渲染时使用我自己的 latex 转义方法 .tex.twig文件。我找到了一种使用以下代码扩展 twig 环境的方法:

//LatexEscapeSetter.php
public function __invoke(Environment $twig)
{
    $twig->getExtension('Twig_Extension_Core')
        ->setEscaper('latex',
                     function ($twig, $string, $charset) {
                         // Escaping logic here....
                     }
        );

    return $twig;
}

为了调用此方法，我在 services.yml 中创建了以下定义:

Twig_Environment:
    class: Twig_Environment
    factory: ['LatexEscapeSetter.php', '__invoke']
    arguments: ['@twig']

重新启动服务器后，我使用了 var_dump($twig->getExtensions())实际上注意到核心扩展确实包含 latex入口。但使用{% autoescape 'latex' %}在我的一个 html 页面中作为测试没有任何影响。
我错过了什么？

Answer 1

这就是你的做法:

首先需要在 twig 命名空间下配置 autoescape_service 和 autoescape_service_method 配置。

twig:
    autoescape_service: 'App\Twig\EscapeStrategy'
    autoescape_service_method: guess

逃逸策略服务必须在 config/services.yaml 或您的自定义服务定义文件中注册:

services:
    App\Twig\EscapeStrategy: ~

在您的用例中，EscapeStrategy 可能如下所示:

<?php

namespace App\Twig;
use Twig\FileExtensionEscapingStrategy;

class EscapeStrategy
{

    const STRATEGY_NAME = 'latex';

    public function guess($name)
    {
        if ('.tex.twig' === substr($name, -9)) {
            return self::STRATEGY_NAME;
        }

        return FileExtensionEscapingStrategy::guess($name);
    }
}

symfony 默认使用 FileExtensionEscapingStrategy，因此最好回退到默认猜测器。

如果您尝试渲染名称以“.tex.twig”结尾的模板，您将收到异常，因为该“latex”策略的处理程序不存在。

要为新的逃逸策略注册处理程序，您需要装饰一个 Twig 服务。 在 services.yaml 中:

services:
    App\Twig\Configurator:
        decorates: 'twig.configurator.environment'

实现可能是这样的:

<?php

namespace App\Twig;

use Symfony\Bundle\TwigBundle\DependencyInjection\Configurator\EnvironmentConfigurator;
use Twig\Environment;
use Twig\Extension\EscaperExtension;

class Configurator
{

    /**
     * @var EnvironmentConfigurator
     */
    private $configurator;

    public function __construct(EnvironmentConfigurator $configurator)
    {
        $this->configurator = $configurator;
    }

    public function configure(Environment $environment)
    {
        $environment->getExtension(EscaperExtension::class)->setEscaper(EscapeStrategy::STRATEGY_NAME, [$this, 'escape']);

        $this->configurator->configure($environment);
    }

    public function escape($twig, $string, $charset)
    {
        //implement escape here
        return $string;
    }
}

如果您不使用 Autowiring ，请检查文档 https://symfony.com/doc/current/service_container/service_decoration.html

还要确保清除缓存，无论开发环境还是生产环境。