Cómo habilitar el debug de Twig en Drupal 8

Cuando estamos creando un diseño a través de las plantillas Twig de Drupal 8, nos es de gran ayuda habilitar el "twig debug" de Drupal 8.

Esta ayuda que nos ofrece Drupal nos permite conocer qué plantilla es la recomendada para el contenido que estamos viendo en pantalla.

Habilitando el Debug

Para activar el debug de Twig debemos ir a /sites/default y abrir el archivo services.yml

Si este archivo no existe podemos copiar default.services.yml y renombrarlo a services.yml

En este archivo deberemos realizar el siguiente cambio:

parameters:
  twig.config:
    debug: TRUE
    auto_reload: TRUE
    cache: FALSE

Activando el debug conseguiremos que drupal nos muestre en el visor de código del explorador, una serie de información que nos ayudará a identificar que plantilla debemos usar en cada caso.

Por otro lado, las plantillas Twig se compilan en clases de PHP en el disco para un mejor rendimiento, pero esto significa que, de forma predeterminada, sus plantillas no se actualizan cuando realiza cambios; motivo por el cual, activaremos auto_reload. 

Por último, desactivamos la cache para que nos permita mayor agilidad a la hora de desarrollar nuestros templates.

No debemos olvidarnos de regresar estos valores a su estado anterior una vez queramos poner el desarrollo en producción.

Con esta configuración, ya sólo nos faltaría limpiar la caché de Drupal 8 y comenzar a implementar nuestro diseño.

Habilitando el Debug (II)

Una manera más profesional y que nos permite más control es generar un archivo por ejemplo con el siguiente nombre: develop.services.yml.

En este archivo colocamos todas nuestras opciones de desarrollo:

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

Una vez generado este archivo, abrimos nuestro archivo settings.php y añadimos el siguiente código al final del mismo:

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

Esto nos va a permitir que, una vez pasemos a un entorno de producción, bastará con cambiar el nombre al archivo develop.services.yml para que éste no sea reconocido y no se activen las opciones de desarrollo.