Twig 模板支持

Twig 模板中的语言注入

在使用 Twig 模板时，您可以在模板块中注入代码片段。 PhpStorm 将为您编辑该代码片段提供全面的语言支持。

将插入符号放置在您希望注入语言的模板块中，然后按 Alt+Enter ，或单击。
选择注入语言或引用，并从弹出菜单中选择您要注入的语言。

自动将 JavaScript 注入 Twig 模板块

PhpStorm 可以根据定义的注入规则自动将代码注入 Twig 模板块。默认情况下，提供了自动注入 JavaScript 代码的规则。

在 Twig 模板中，执行以下任一操作：
- 添加一个名为 javascript 的块，如下所示：
  {% block javascript %} //injected JavaScript code {% endblock %}
- 添加一个自定义的 script 块，如下所示：
  {% script %} //injected JavaScript code {% endscript %}
PhpStorm 将自动将 JavaScript 注入模板块。

自定义 Twig 语法

在某些情况下，可能需要自定义 Twig 语法。例如，这在避免与其他模板语言（如 AngularJS ）冲突时非常有用。

在代码中，根据 Twig 文档中描述的内容自定义 Twig 语法。
在 PhpStorm 中进行相应的调整，以便其能够正确识别此语法。
在设置对话框（Ctrl+Alt+S ）中，转到 PHP | Twig 并输入要用于 Tag、 Comment 和 变量 块的所需值。

调试 Twig 模板

您可以使用与常规 PHP 文件相同的技术调试 Twig 模板。

在开始之前，请确保在 \Twig\Environment 实例中设置了以下选项：

                debug: true
                auto_reload: true

启用 Twig 调试

在设置对话框（Ctrl+Alt+S ）中，转到 PHP | 调试 | 模板并展开 Twig 调试区域。
在缓存路径字段中，提供 Twig 已编译模板缓存文件夹的绝对路径。手动输入路径或单击并在打开的对话框中选择相关文件夹。默认情况下，已编译的 Twig 模板存储在项目内的 var/cache/{environment}/twig 文件夹中，其中 {environment} 表示您的配置环境，例如 dev 或 prod。

开始调试会话

按照终极调试指南中描述的内容开始调试会话。最简单且推荐的方法是使用零配置调试：

选择并安装适合您浏览器的浏览器扩展。
在 PhpStorm 工具栏上，切换以开始监听传入的 PHP 调试连接，或从主菜单中选择运行 | 开始侦听PHP 调试连接。
请在您的代码中设置一个 breakpoint。
使用已安装的浏览器扩展在浏览器中启动调试会话。
在调试会话期间，检查程序状态：查看变量值、评估表达式、逐步执行程序等。

在调试会话期间，如果模板断点不可达（即模板行未映射到任何已编译 PHP 文件中的行），PhpStorm 将向您发出警告。

Twig 模板中的不可达断点

最后修改日期： 2025年 9月 26日