Режим отладки в Drupal 8

В новой ветке нашей любимой CMF режим отладки несколько изменился. Если в 7ке нам достаточно было отключить кеширование из админ панели и можно было дальше смело дебажить все наши наработки, то теперь от кеширования так «просто» не избавиться. Этим мы сейчас с вами и займемся.

Отключаем кеширование

Итак, у нас есть чистая установка Drupal 8, со стандартной темой Bartik активированной по умолчанию. Первое, что нам необходимо сделать – это убедиться, что кеширование в админке сайта у нас отключено. Идем по пути Конфигурация -> Производительность:

И в пункте «Кеширование» выбираем «Не кешировать».

Далее приступаем к более интересному моменту, а именно к файлам конфигурации. Нам нужно скопировать файл

example.settings.local.php

который, находится в корне папки /sites на вашем сервере, в корень папки /sites/default и переименовать его в

settings.local.php

Данный файл определяет параметры при разработке вашего сайта. В данном файле ищем запись вида:

# $settings['cache']['bins']['render'] = 'cache.backend.null';

Которую, собственно нам нужно разкомментировать (удалить решетку # в начале записи).

Теперь открываем файл

settings.php

и ищем запись вида

# if (file_exists(__DIR__ . '/settings.local.php')) {
#   include __DIR__ . '/settings.local.php';
# }

Которую также нужно разкоментировать. Данная запись говорит о том, что если существует файл settings.local.php, то подключить его.

Хочу заменить, если после указанных манипуляций вы получаете сообщение о непредвиденной ошибке, то запустите файл rebuild.php, он перестроит ваши параметры сайта.

Включаем отладку шаблонизатора Twig

Открываем файл

development.services.yml

который, находится в корне папки /sites и дописываем следующую запись:

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

Список дополнительных параметров вы можете найти в файле default.services.yml, который находится в корне /sites/default

После чего чистим кеш сайта и наблюдаем результат:

Отладка переменных внутри шаблонов Twig

Для отладки переменных внутри Twig шаблонов, можно использовать

 {{ dump(variable) }}

Например {{ dump(page) }} - для отладки внутри page.htm.twig или с использованием Devel, который приобрел PHP отладчик – Kint.

{{ kint(page) }}

Более подробно о Kint вы можете прочитать здесь.