在 Drupal 8 的 Twig 模板中启用调试

引言

Twig 是一个灵活、快速且安全的模板框架，或者说是 PHP 的现代引擎，它被 Drupal 8 集成。Twig 主题调试可以帮助开发者有效地开发新模板和操作现有模板。

启用 Twig 调试模式后，每个 Twig 模板的标记都会在 HTML 中显示，可以通过查看页面源代码或浏览器开发者工具清晰地看到。

有两种类似的方法可以启用 Twig 主题调试。

选项 1

这是最简单的方法。按照以下步骤顺序操作，通过修改一个文件 services.yml 来启用 Twig 模板调试。

1. 导航到目录 /sites/default。
2. 复制 default.services.yml 文件并将其重命名为 services.yml。
3. 打开 services.yml 文件并找到 'twig.config'。
4. 将 debug 设置为 true。

   (可选：将 auto_reload 设置为 true，并将 cache 设置为 false)

   parameters:
     twig.config:
       debug: true
       auto_reload: true
       cache: false

5. 清除缓存。

选项 2

如果需要根据特定环境设置不同的配置，可以选择此方法。按照以下步骤顺序操作，以启用 Twig 模板调试。

1. 导航到目录 /sites。
2. 复制 example.settings.local.php 文件，重命名为 settings.local.php，并将其放置在目录 /sites/default 中。
3. 打开位于相同 /sites 目录中的 development.services.yml 文件，并添加代码，使整个文件看起来像这样（注意缩进）。

   parameters:
     http.response.debug_cacheability_headers: true
     twig.config:
       debug: true
       auto_reload: true
       cache: false
   services:
     cache.backend.null:
       class: Drupal\Core\Cache\NullBackendFactory

4. 导航到目录 /sites/default。
5. 打开 settings.php 并取消注释以下代码

   if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
     include $app_root . '/' . $site_path . '/settings.local.php';
   }

6. 清除缓存。

历史

• 2019 年 10 月 2 日：初始版本