auto_reload

тип: boolean за замовчуванням: '%kernel.debug%'

Якщо true, то кожний раз при відображенні шаблону, Symfony спочатку перевіряє, чи змінився початковий код після останньої компіляції. Якщо змінився, то шаблон комплюється знову автоматично.

autoescape

тип: boolean або string за замовчуванням: 'name'

Якщо false, то автоматичне ерканування вимкнено (ви всеодно можете екранувати зміст індивідуально в шаблонах).

Якщо воно встановлене як рядок, то зміст шаблону екранується з використанням стратегії з цим ім'ям. Дозволені значення: html, js, css, url, html_attr і name. Значення за замовчуванням - name. Ця стратегія екранує зміст у відповідності до розширення імені шаблону (наприклад, використовує html для шаблонів *.html.twig, і js для шаблонів *.js.html).

autoescape_service

тип: string за замовчуванням: null

Починаючи з Twig 1.17, стратегія екранування, застосована за замовчуванням до шаблону, визначається під час компіляції, засновуючись на імені файлу шаблону. Це означає, наприклад, що зміст шаблону *.html.twig екранується для HTML, а зміст *.js.twig - для JavaScript.

Ця опція дозволяє визначити сервіс Symfony, який буде використано, щоб визначити екранування за замовчуванням, застосоване до шаблону.

autoescape_service_method

тип: string за замовчуванням: null

Якщо визначена опція autoescape_service, то ця опція визначає метод, який викликається для визначення екранування за замовчуванням, застосованого до шаблону.

base_template_class

тип: string за замовчуванням: 'Twig\Template'

Шаблони Twig компілюються в PHP-класи до їх використання для відображення змісту. Ця опція визначає базовий клас, з якого розширюються всі класи шаблонів. Використання користувацького базового шаболну не схвалюється, так як це ускладнить зміст вашого додатку.

cache

тип: string | false за замовчуванням: '%kernel.cache_dir%/twig'

До використання шаблонів Twig для відображення деякого змісту, вони компілюються у звичайний PHP-код. Компіляція - це витратний процес, так що результат кешується у каталог, визначений цією опцією конфігурації.

Встановіть цю опцію як false, щоб відключити компіляцію шаблону Twig. Однак, це не рекомендується; навіть в середовищі dev, так як опція auto_reload гарантує, що змінени кешовані шаблони будуть скомпільовані знову.

charset

тип: string за замовчуванням: '%kernel.charset%'

Набір символів, який використовується файлами шаблонів. За замовчуванням, це те ж значення, що і параметр контейнера kernel.charset , який за замовчуванням у додатках Symfony встановлений як UTF-8.

date

Ці опції визначають значення за замовчуванням, які використовуються фільтром date для форматування значень дати та часу. Вони корисні для запобігання передачі одних і тих самих аргументів на кожний виклик фільтра date.

debug

тип: boolean за замовчуванням: '%kernel.debug%'

Якщо true, то скомпільовані шаблони включають в себе метод __toString(), який може бути використаний для відображення їх вузлів.

default_path

тип: string за замовчуванням: '%kernel.project_dir%/templates'

Шлях до каталогу, де Symfony шукатиме шаблони додатку Twig за замовчуванням. Якщо ви зберігаєте ці шаблони більше ніж у одному каталозі, використайте також опцію paths.

form_themes

тип: array в string за замовчуванням: ['form_div_layout.html.twig']

Визначає одну або більше тему форми, які застосовуються до всіх форм додатку:

1
2
3
4

# config/packages/twig.yaml
twig:
    form_themes: ['bootstrap_4_layout.html.twig', 'form/my_theme.html.twig']
    # ...

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<!-- config/packages/twig.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:twig="http://symfony.com/schema/dic/twig"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/twig https://symfony.com/schema/dic/twig/twig-1.0.xsd">

    <twig:config>
        <twig:form-theme>bootstrap_4_layout.html.twig</twig:form-theme>
        <twig:form-theme>form/my_theme.html.twig</twig:form-theme>
        <!-- ... -->
    </twig:config>
</container>

1
2
3
4
5
6
7
8
9
10
11

// config/packages/twig.php
use Symfony\Config\TwigConfig;

return static function (TwigConfig $twig) {
    $twig->formThemes([
        'bootstrap_4_layout.html.twig',
        'form/my_theme.html.twig',
    ]);

    // ...
};

Порядок, в якому визначаються теми, важливий, так як кожна тема перевизначає усі попередні. При відображення поля форми, блок якої не визначено в темі форми, Symfony використовує попередні теми до першої.

Ці глобальні теми застосовуються до всіх форм, навіть тих, які використовують тег Twig form_theme, але ви можете віключити глобальні теми для конкретних форм .

globals

тип: array за замовчуванням: []

Визначає глобальні змінні автоматично врповаджені у всі шаблони Twig. Дізнайтеся більше про глобальні змінні Twig.

number_format

Ці опції визначають значення за замовчуванням, які використовуються фільтром number_format для форматування числових значень. Вони корисні для запобігання передачі одних і тих же аргументів за кожним викликом фільтра number_format.

optimizations

тип: integer за замовчуванням: -1

Twig включає в себе розширення під назвою optimizer, яке підключається за замовчуванням у додатках Symfony. Це розширення аналізує шаблони для їх оптимізації при компіляції. Наприклад, якщо ваш шаблон не використовує спеціальну змінну loop всередині тегу for, то це розширення видаляє ініціалізацію невикористаної змінної.

За замовчуванням, ця опція - -1, що означає, що всі оптимзації увімкнено. Встановіть її як 0, щоб відключити всі оптимізації. Ви навіть можете увімкнути або відключити ці оптимізації вибірково, як пояснюється у документації Twig про розширення оптимізатора.

paths

тип: array за замовчуванням: null

Визначає каталоги, де Symfony шукатиме шаблони Twig на додаток до каталогу, визначеному в опції default_path:

1
2
3
4
5
6

# config/packages/twig.yaml
twig:
    # ...
    paths:
        'email/default/templates': ~
        'backend/templates': 'admin'

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<!-- config/packages/twig.xml -->
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:twig="http://symfony.com/schema/dic/twig"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/twig https://symfony.com/schema/dic/twig/twig-1.0.xsd">

    <twig:config>
        <!-- ... -->
        <twig:path>email/default/templates</twig:path>
        <twig:path namespace="admin">backend/templates</twig:path>
    </twig:config>
</container>

1
2
3
4
5
6
7
8
9

// config/packages/twig.php
use Symfony\Config\TwigConfig;

return static function (TwigConfig $twig) {
    // ...

    $twig->path('email/default/templates', null);
    $twig->path('backend/templates', 'admin');
};

Прочитайте більше про каталоги та простори імен шаблонів .

strict_variables

тип: boolean за замовчуванням: %kernel.debug%

Якщо встановлена як true, Symfony відображає виключення кожний раз, коли не існує змінної, атрибуту або методу Twig. Якщо встановлена як false, то ці помилки ігноруються, а неіснуючі значення замінюються на null.