如何配置非Symfony环境下的Twig实现双花括号内容自动转义？

我之前也碰到过这个Twig自动转义不生效的坑，结合你的配置情况，给你几个排查方向和具体解决办法：

1. 先确认模板文件的扩展名 #

Twig的自动转义是根据模板文件扩展名自动触发的，默认只有.html.twig、.htm.twig这类带html前缀的模板文件，才会自动启用HTML转义。如果你的模板文件只是.twig（没有html后缀），那自动转义不会生效。

解决办法：

• 把模板文件重命名为xxx.html.twig格式，比如index.html.twig，这样Twig会自动识别并启用HTML自动转义。

2. 检查Loader类型与模板来源 #

如果你用的是Twig_Loader_String（直接加载字符串模板），Twig无法通过扩展名判断自动转义规则，这时候即使配置了autoescape: 'html'也不会生效。

解决办法：

方案A：在字符串模板中手动开启自动转义块 #

{% autoescape 'html' %}
    {{ var1 }}
    {{ var2 }}
    {{ varN }}
{% endautoescape %}

方案B：配置全局自动转义回调函数 #

修改Twig实例的配置，通过回调函数强制对所有模板启用HTML转义：

$twig = new Twig_Environment($loader, [
    'autoescape' => function ($templateName) {
        // 对所有模板强制启用HTML转义
        return 'html';
    },
    'cache' => false,
]);

3. 排查模板中是否手动关闭了自动转义 #

检查你的模板代码，有没有出现以下两种情况：

• 全局或局部使用了{% autoescape false %}块，会关闭该块内的自动转义
• 变量输出时使用了|raw过滤器，会强制跳过转义

如果有这些代码，要么移除，要么在需要转义的变量上单独保留|e过滤器。

4. 确认Twig版本的兼容性 #

你用的Twig_Environment是Twig 1.x的写法，如果你实际安装的是Twig 2.x或更高版本，虽然向下兼容，但建议使用命名空间的写法确保配置生效：

use Twig\Environment;
use Twig\Loader\FilesystemLoader;

$loader = new FilesystemLoader('/path/to/templates');
$twig = new Environment($loader, [
    'autoescape' => 'html',
    'cache' => false,
]);

按上面的步骤排查，基本就能解决自动转义不生效的问题啦！

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