PhpStorm 2021.3 Help

树枝模板

除了通用模板支持之外,Symfony 插件还提供了针对Twig 模板语言的补全、导航和代码检查。

Twig 模板中的代码完成

在编辑器中,按下Ctrl+Space以调用代码完成并执行以下任一操作:

  • 为任何TWIG文件中的适当功能提供模板和块。

    Twig 模板中的名称补全
  • 提供自定义或从第三方安装的扩展、过滤器和宏。

    Twig 模板中的扩展完成
  • 提供单个资产和完整的捆绑包。

    Twig 模板中的资产名称完成

Twig 模板中的代码导航

要导航到模板、块、扩展、过滤器、宏或资产的声明,请将插入符号放在其使用处,然后按Ctrl+B。或者,Ctrl+Click用法。

导航到 Twig 模板中的扩展

Twig 模板中的代码检查

如果我们引用应用程序未知的资产(例如,如果资产尚不存在),PhpStorm 会显示来自缺失资产检查的相应警告。.

缺少树枝资产检查

使用 Twig 变量

在 Twig 模板中,您可以使用{# variable_name variable_value #}语法定义变量,例如:

{# 姓名约翰 #}

一旦定义了变量,代码完成 ( Ctrl+Space) 和导航到声明 ( Ctrl+B) 就变得可用。

以类似的方式,您可以通过添加注释来定义使用模板的控制器,controller例如:

{# @controller BloggerBlogBu​​ndle:Home:index #}

一旦我们这样做了,PhpStorm 将为传递到模板中的所有变量提供代码完成和导航。

Twig 变量名补全

Twig 模板中的语言注入

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

  1. 将插入符号放在要在其中注入语言的模板块内,然后按Alt+Enter,或单击意图操作按钮

  2. 选择注入语言或参考,然后从弹出菜单中选择要注入的语言。

    在 Twig 模板中注入代码

自动将 JavaScript 注入 Twig 模板块

PhpStorm 可以根据定义的注入规则自动将代码注入到 Twig 模板块中。开箱即用,自动注入 JavaScript 代码的规则可用。

  • 在 Twig 模板中,执行以下任一操作:

    • javascript添加一个如下命名的块:

      {% block javascript %} //注入的 JavaScript 代码 {% endblock %}
    • 添加自定义script块,如下所示:

      {% script %} //注入的 JavaScript 代码 {% endscript %}

    PhpStorm 会自动将 JavaScript 注入到模板块中。

    在 Twig 模板中自动注入 JavaScript 代码

自定义 Twig 语法

在某些情况下,可能需要自定义 Twig 语法。这可能很有用,例如,避免与其他模板语言(如AngularJS )发生冲突。

  1. 在您的代码中,按照Twig 文档中的描述自定义 Twig 语法。

  2. 在 PhpStorm 中进行相应的调整,使其能够正确识别该语法。

    设置/首选项对话框 ( Ctrl+Alt+S) 中,转到PHP | Twig并键入要用于 、 和 块的Tag所需CommentVariable

    自定义 Twig 语法

调试 Twig 模板

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

在开始之前,请确保已设置以下Twig 环境选项

调试:真 auto_reload:真

启用 Twig 调试

  1. 设置/首选项对话框 ( Ctrl+Alt+S) 中,转到PHP | 调试 | 模板并展开Twig 调试区域。

  2. 缓存路​​径字段中,提供 Twig编译模板缓存文件夹的绝对路径。手动键入路径或单击浏览按钮并在打开的对话框中选择相关文件夹。默认情况下,已编译的 Twig 模板存储在项目内的var/cache/{environment}/twig文件夹中,其中{environment}指定了您的配置环境,例如devprod

启动调试会话

按照Ultimate 调试指南中的说明启动调试会话。最简单和推荐的方法是使用零配置调试

  1. 选择并安装适合您浏览器的浏览器扩展。

  2. 在 PhpStorm 工具栏上,切换开始侦听 PHP 调试连接按钮以开始侦听传入的 PHP 调试连接,或选择Run | 从主菜单开始侦听 PHP 调试连接。

  3. 在代码中设置断点

  4. 使用已安装的浏览器扩展在浏览器中启动调试会话。

  5. 在调试会话期间,检查程序状态:查看变量值、计算表达式、逐步执行程序等。

在调试会话期间,PhpStorm 会在模板断点不可达的情况下向您发出警告,这种情况发生在模板行未映射到编译的 PHP 文件中的任何行时。

Twig 模板中无法访问的断点
最后修改时间:2021 年 8 月 3 日