enabled

тип: boolean по умолчанию: false

debug

тип: boolean по умолчанию: %kernel.debug%

Если true, вызваются исключения, когда что-то идёт не так. В обратном случае, кеш будет пробовать продолжать работу и предоставлять значимый ответ.

trace_level

тип: string возможные значения: 'none', 'short' или 'full'

Длч 'short', краткий след основного запроса будет добавлен как HTTP-заголовок. 'full' добавит следы всех запросов (включая подзапросы ESI) (по умолчанию: 'full', если в режиме отладки; 'none' - в других случаях).

trace_header

тип: string

Имя заголовка, который нужно использовать для следов (по умолчанию: X-Symfony-Cache).

default_ttl

тип: integer

Количество секунд, в течение которых запись кеша должна считаться свежей, если не было предоставлено ясной информации о свежести в ответе. Ясные Cache-Control или заголовки Expires переопределяют это значение (по умолчанию: 0).

private_headers

тип: array

Набор заголовоков запроса, которые вызывают "приватное" поведение контроля кеша в ответах, которые ясно не указывают, является ответ приватным или публичным, через директиву Cache-Control (по умолчанию: Authorization и Cookie).

allow_reload

тип: string

Указывает, может ли клиент форсировать перезагрузку кеша, включив директиву Cache-Control "no-cache" в запрос. Установите как true для соответствия RFC 2616 (по умолчанию: false).

allow_revalidate

тип: string

Указывает, может ли клиент форсировать повторную валидацию кеша, включив директиву Cache-Control "max-age=0" в запрос. Установите как true для соответствия RFC 2616 (по умолчанию: false)

stale_while_revalidate

тип: integer

Указывает количество секунд по умолчанию (гранулярность - секунда, так как точность TTL ответа - секунда), во время которого кеш может немедленно вернуть несвежий ответ во время фоновой повторной валидации (по умолчанию: 2). Эта установка переопределяется расширением HTTP Cache-Control stale-while-revalidate (см. RFC 5861).

stale_if_error

тип: integer

Указывает количество секунд по умолчанию (гранулярность - секунда), во время которого кеш может выдать несвежий ответ в случае ошибки (по умолчанию: 60). Эта установка переопределяется расширением HTTP Cache-Control the stale-if-error (см. RFC 5861).

terminate_on_cache_hit

тип: boolean по умолчанию: true

Если true, событие kernel.terminate развёртывается, даже если есть попадание в кеш.

Разве что вашему приложению не нужно обрабатывать события при попаданиях в кеш, рекомендуется установить это как false, чтобы улучшить производительность, так как это избегает необходимости начальной загрузки фреймворка Symfony при попадании в кеш.

enabled_locales

тип: array по умолчанию: [] (пустой массив = включить все локали)

Приложения Symfony по умолчанию генерируют файлы переводов для сообщений валидации и безопасности для всех локалей. Если ваше приложение использует только некоторые локали, используйте эту опцию, чтобы ограничить сгенерированные Symfony файлы и немного улучшить производительность:

1
2
3

# config/packages/translation.yaml
framework:
    enabled_locales: ['en', 'es']

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

<!-- config/packages/translation.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <enabled-locale>en</enabled-locale>
        <enabled-locale>es</enabled-locale>
    </framework:config>
</container>

1
2
3
4
5
6

// config/packages/translation.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->enabledLocales(['en', 'es']);
};

Если некоторый пользователь делает запросы с локалью, не включенной в эту опцию, приложение не отобразит ошибки, так как Symfony отобразит содержание, используя резеврную локаль.

set_content_language_from_locale

тип: boolean по умолчанию: false

Если эта опция установлена как true, ответ будет иметь HTTP-заголовок Content-Language, установленный с локалью Request.

set_locale_from_accept_language

тип: boolean по умолчанию: false

Если эта опция установлена как true, локаль Request будет автоматически установлена в значение HTTP-заголовка Accept-Language.

Когда передается атрибут запроса _locale, заголовок Accept-Language игнорируется.

enabled

тип: boolean по умолчанию: `true или false, в зависимости от вашей установки

Включать сервисы формы в сервис-контейнере или нет. Если вы не используете формы, установка этой опции, как false может улучшить производительность вашего приложения, так как в контейнер будет загружаться меньше сервисов.

Эта опция будет автоматически установлена, как true, когда будет сконфигурирована одна из дочерних настроек.

field_name

тип: string по умолчанию: _token

Это имя поля, которое вы должны дать полю CSRF-токена ваших форм.

enabled

тип: boolean по умолчанию: true или false, в зависимости от вашей установки

Эта опция может быть использована, чтобы отключить CSRF-защиту во всех формах. Но вы также можете отключить CSRF-защиту в индивидуальных формах`.

1
2
3
4

# config/packages/framework.yaml
framework:
    # ...
    csrf_protection: true

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony
        https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    <framework:config>
        <framework:csrf-protection enabled="true"/>
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;
return static function (FrameworkConfig $framework) {
    $framework->csrfProtection()
        ->enabled(true)
    ;
};

Если вы используете формы, но хотите избежать запуска вашей сессии (например, используя формы на сайте только с API), то csrf_protection должна быть установлена, как false.

enabled

тип: boolean по умолчанию: false

Включать ли поддержку ESI в фреймворке.

Вы также можете установить esi, как true, чтобы включить её:

1
2
3

# config/packages/framework.yaml
framework:
    esi: true

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:esi/>
    </framework:config>
</container>

1
2
3
4
5
6

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->esi()->enabled(true);
};

enabled

тип: boolean по умолчанию: false

Включать ли слушатель фрагментов, или нет. Слушатель фрагментов используется, чтобы отображать ESI-фрагменты независимо от остальной страницы.

Эта установка автоматически имеет значение true, когда конфигурируется одна из дочерних установок.

hinclude_default_template

тип: string по умолчанию: null

Устанавливает содержание, отображаемое во время загрузки фрагмента, или когда отключен JavaScript. Может бвть либо именем шаблона, либо самим содержанием.

path

тип: string по умолчанию: '/_fragment'

Префикс пути для фрагментов. Слушатель фрагментов будет выполнен только когда запрос начинается с этого пути.

auth_basic

тип: string

Имя пользователя и пароль, используемые для создания HTTP-заголовка Authorization, используемого в аутентификации базового HTTP. Значение этой опции должно следовать формату username:password.

auth_bearer

тип: string

Токен, используемый для создания HTTP-заголовка Authorization, используемого в аутентификации HTTP Bearer (также называется аутентификацией токенов).

auth_ntlm

тип: string

Имя пользователя и пароль, используемые для создания HTTP-заголовка Authorization, используемого в протоколе аутентификации Microsoft NTLM. Значение этой опции должно следовать формату username:password. Этот механизм аутентификации требует использования транспорта, основанного на cURL.

base_uri

тип: string

URI, который слияется в относительные URI, следуя правилам, разъясненным в стандарте RFC 3986. Это полезно, когда все сделанные вами запросы имеют общий префикс (например, https://api.github.com/), и вы можете избежать его добавления к каждому запросу.

Вот некоторые распространенные примеры того, как на практике работает слияение base_uri:

bindto

тип: string

Имя интерфейса сети, IP-адрес, имя хостинга или UNIX-сокет для использования в качестве исходящего интерфейса сети.

buffer

тип: boolean | Closure

Буферизация ответа означает, что вы можете получать доступ к его содержимому множетство раз, не выполняя запрос снова. Буферизация подключается по умолчанию, когда тип содержания ответа - text/*, application/json или application/xml.

Если эта опция является булевым значение, ответ буферизируется, когда значение - true. Если эта опция является замыканием, ответ буферизируется, когда возвращенное значение - true (замыкание получает в качестве аргумента массив с заголовками ответов).

cafile

тип: string

Путь файла центра сертификации, который содержит один или более сертификатов, используемых для верификации сертификатов других серверов.

capath

тип: string

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

ciphers

тип: string

Список имен шифров, разрешенных для соединений SSL/TLS. Они могут быть разделены двоеточиями, запятыми или пробелами (например, 'RC4-SHA:TLS13-AES-128-GCM-SHA256').

delay

тип: integer по умолчанию: 1000

Изначальная задержа в миллисекундах, используемая для вычисления времени ожидания между повторными попытками.

enabled

тип: boolean по умолчанию: false

Подключать ли поддержку повторных попыток неуспешного HTTP-запроса. Эта установека автоматически имеет значение "true", если сконфигурирована одна из дочерних настроек.

headers

тип: array

Ассоциированный массив HTTP-заголовков, добавленный перед тем, как сделать запрос. Это значение должно использовать формат ['header-name' => 'value0, value1, ...'].

http_codes

тип: array по умолчанию: DEFAULT_RETRY_STATUS_CODES()

Список HTTP статус-кодов, вызывающих повторную попытку запроса.

http_version

тип: string | null по умолчанию: null

HTTP-версия для использования, обычно '1.1' или '2.0'. Отсавьте, как null, чтобы позволить Symfony выбрать лучшую версию автоматически.

jitter

тип: float по умолчанию: 0.1 (должно быть между 0.0 и 1.0)

Эта опция добавляет некоторую рандомность к задержке. Полезно для избегания отправки множества запросов к серверу в одно и то же время. Рандомность вычисляется как задержка * джиттер. Например: если задержка - 1000ms, а джиттер - 0.2, реальзная задержка будет числом между 800 и 1200 (1000 +/- 20%).

local_cert

тип: string

Путь файла, который содержит сертификат в PEM формате, используемый HTTP- клиентом, Часто комбинируется с опциями local_pk и passphrase.

local_pk

тип: string

Путь файла, который содержит приватный ключ в PEM формате сертификата, определенного в опции local_cert.

max_delay

тип: integer по умолчанию: 0

Максимальное количество в миллисекундах для ожидания между повторными попытками. Используйте 0, чтобы не ограничивать длительность.

max_duration

тип: float по умолчанию: 0

Максимальное время выполнения, в секундах, которое могут использовать запрос и ответ. Значение, ниже чем или равное 0, означает, что время не ограничено.

max_host_connections

тип: integer по умолчанию: 6

Определяет максимальное количество одновременно открытых соединений с одним хостингом (рассматривая "хостинг" как эквивалент пары "имя хостинга + номер порта"). Это ограничение также применяется для соединений прокси, где прокси рассматривается как хостинг, для которого применяется данное ограничение.

max_redirects

тип: integer по умолчанию: 20

Максимальное количество следуемых перенаправлений. Используйте 0, чтобы не следовать ни одному перенаправлению.

max_retries

тип: integer по умолчанию: 3

Максимальное количество повторных попыток для неуспешных запросов. Когда максимум достигнут, клиент возвращает последний полученный ответ.

multiplier

тип: float по умолчанию: 2

Это значение умножается на ожидание каждый раз при возникновении повторной попытки, чтобы распределить повторные попытки во времени, а не делать их все друг за другом.

no_proxy

тип: string | null по умолчанию: null

Список хостингов, разделенный запятыми, которые не требуют достижения прокси, даже если он сконфигурирован; Используйте заполнитель '*', чтобы совпадали все хостинги, и пустую строку, чтобы не совпадал ни одни (отключает прокси).

passphrase

тип: string

Кодовая фраза, используемая для шифрования сертификата, хрнаящегося в файле, определенном в опции local_cert.

peer_fingerprint

тип: array

При рассмотрении TLS или SSL соединения, сервер отправляет сертификат, указывающий на его идентичность. Публичный ключ извлекается из этого сертификата, и если он точно не совпадает ни с одним из предоставленных в этой опции публичных ключей, соединение прерывается до отправки или получения любых данных.

Значение этой опции - ассоциированный массив algorithm => hash (например, ['pin-sha256' => '...']).

proxy

тип: string | null

HTTP-прокси для использования в запросах. Оставьте как null, чтобы определять прокси автоматически, основываясь на конфигурации вашей системы.

query

тип: array

Ассоциированный массив значений строки запросы, добавленных к URL перед выполнением запроса. Это значение должно использовать формат ['parameter-name' => parameter-value, ...].

resolve

тип: array

Список имен хостингов и их IP-адресов для предварительного наполнения DNS-кеша, используемого HTTP-клиентом для того, чтобы избежать поиска этих хостингов в DNS. Эта опция полезна для улучшения безопасности, когда IP проверяются перед тем, как URL передается клиенту, и делает ваши тесты проще.

Значение этой опции является ассциированным массивом domain => IP address (например, ['symfony.com' => '46.137.106.254', ...]).

retry_strategy

тип: string

Сервис используется, чтобы решить, стоит ли делать повторную попытку запроса, и вычислить время ожидания между попытками. По умолчанию, использует экземпляр GenericRetryStrategy, сконфигурированный с опциями http_codes, delay, max_delay, multiplier и jitter. Этот класс должен реализовать RetryStrategyInterface.

scope

тип: string

Только для видимых клиентов: регулярное выражение, которому должен соответствовать URL перед его применением ко всем другим опциям не по умолчанию. По умолчанию, область выводится из base_uri.

timeout

тип: float по умолчанию: зависит от вашей конфигурации PHP

Время, в секундах, для ожидания ответа. Если ответ будет без состояния дольше, вызывается TransportException. Значение по умолчанию такое же, как и значение опции конфигурации PHP default_socket_timeout.

verify_host

тип: boolean по умолчанию: true

Если true, сертификат, отправленный другими серверами, верифицируется, чтобы гарантировать, что их общее имя совпадает с хостингом, влкюченным в URL. Обычно комбинируется с verify_peer, чтобы также верифицировать аутентичность сертификата.

verify_peer

тип: boolean по умолчанию: true

Если true, сертификат, отправленный другими серверами, при выборе между TLS или SSL соединениями, верифицируется на аутентичность. Аутентификации сертификата недостаточно, чтобы быть уверенными в сервере, поэтому вы должны комбинировать это с опцией verify_host.

enabled

тип: boolean по умолчанию: false

Профилировщик может быть включен путём установки этой опции, как true. Когда вы используете стандартную версию Symfony, профилировщик включается в окружениях dev и test.

collect

тип: boolean по умолчанию: true

Эта опция конфигурирует то, как ведёт себя профилировщик, когда он включен. Если установлена, как true, то профилировщик собирает данные для всех запросов. Если вы хотите собирать информацию только по запросу, то вы можете установить отметку collect, как false, и активировать сборщики данных вручную:

1

$profiler->enable();

collect_parameter

тип: string по умолчанию: null

Это указывает имя параметра запроса, параметра тела или атрибут запроса, используемые для включения или отключения коллекции данных профилировщиком для каждого запроса. Скомбинируйте с опцией collect, чтобы включать/отключать профилировщик по требованию:

• Если опция collect установлена как true, но этот параметр существует в запросе и имеет любое значение, кроме true, yes, on или 1, данные запроса не будут собраны;
• Если опция collect установлена как false, но этот параметр существует в запросе и имеет значение true, yes, on или 1, данные запроса будут собраны.

only_exceptions

тип: boolean по умолчанию: false

Когда она установлена, как true, профилировщик будет включен только, когда вызывается исключение во время обработки запроса.

only_main_requests

тип: boolean по умолчанию: false

Когда установлена как true, профилировщик будет включен только в главных запросах (а не в подзапросах).

dsn

тип: string по умолчанию: 'file:%kernel.cache_dir%/profiler'

DSN, где хранить информацию профилирования.

collect_serializer_data

тип: boolean по умолчанию: false

Установите эту опцию как true, чтобы включить коллектор данных сериализатора и его панель профилировщика. Когда эта опция true, все нормализаторы и кодировщики декорируются отслеживаемыми реализациями, которые собирают информацию профилирования о них.

name

тип: prototype

Имя слушателя частоты, которого вы хотите создать.

formats

тип: array по умолчанию: []

Эта настройка используется для ассоциации дополнительных форматов запросов (например, html) к одному или более mime-типам (например, text/html), которая позволит вам использовать формат и mime-типы для вызова Request::getFormat($mimeType) или Request::getMimeType($format).

На практике, это важно, так как Symfony использует её, чтобы автоматически устанавливать заголовок Content-Type в Response (если вы не указываете его ясно). Если вы передадите массив mime-типов, первый будет использован для заголовка.

Чтобы сконфигурировать формат jsonp:

1
2
3
4
5

# config/packages/framework.yaml
framework:
    request:
        formats:
            jsonp: 'application/javascript'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony
        http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:request>
            <framework:format name="jsonp">
                <framework:mime-type>application/javascript</framework:mime-type>
            </framework:format>
        </framework:request>
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->request()
        ->format('jsonp', 'application/javascript');
};

resource

тип: string обязательно

Путь главного источника маршрутизации (например, YAML-файл), содержащий маршруты и импорт, который должен загружать маршрутизатор.

type

тип: string

Тип источника, намекающий загрузчикам о формате. Не нужно, если вы используете маршрутизаторы по умолчанию с ожидаемыми расширениями файлов (.xml, .yml или .yaml, .php)

default_uri

тип: string

URI по умолчанию, используемый для генерирования URL в контексте вне HTTP (см. Генерирование URL в командах ).

http_port

тип: integer по умолчанию: 80

Порт для нормальных http-запросов (используется при сопоставлении схемы).

https_port

тип: integer по умолчанию: 443

Порт для http-запросов (используется при сопоставлении схемы).

strict_requirements

тип: mixed по умолчанию: true

Определяет поведение генератора маршрутизации. При генерировании маршрута, который имеет особенные требования параметров , генератор может вести себя по-другому, если использованные параметры не соответствуют этим требованиям.

Значение может быть следующим:

true

Выдать исключение, если требования не выполнены;

false

Отключить исключения, если требования не выполнены и вернуть вместо этого '';

null

Отключить проверку требований (т.е. сопоставлять маршрут даже если требования не выполнены).

true рекомендуется в окружении разработки, а false или null - лучше в производстве.

utf8

тип: boolean по умолчанию: false

Когда эта опция установлена как true, регулярные выражения, используемые в требованиях параметров маршрута , будут запущены с использованием модификатора utf-8. Это, к примеру, будет совпадать с любым символом UTF-8 при использовании ., вместо соотнесения только с одним байтом.

Если набор знаков вашего приложения - UTF-8 (как определено в методе getCharset() вашего ядра), рекомендуется установить true. Это приведет к тому, что не-UTF8 URL будут генерировать ошибки 404.

cache_dir

тип: string по умолчанию: %kernel.cache_dir%

Каталог, где будет кеширована информация маршрутизации. Может быть установлена как ~ (null), чтобы отключить кеширование маршрутов.

storage_factory_id

тип: string по умолчанию: 'session.storage.factory.native'

ID сервиса, используемого для создания SessionStorageInterface, который хранит сессию. Этот сервис доступен в приложении Symfony через псевдоним сервиса session.storage.factory. Класс должен реализовать SessionStorageFactoryInterface. Чтобы увидеть список всех доступных хранилищ, выполните:

1

$ php bin/console debug:container session.storage.factory.

handler_id

тип: string по умолчанию: 'session.handler.native_file'

Id сервиса, используемый для хранения сессии. Значение по умолчанию, 'session.handler.native_file', позволит Symfony управлять сессиями самостоятельно, используя файлы для хранения метаданных сессий. Установите как null, чтобы использовать нативный механизм PHP-сессии. Вы также можете хранить сессии в базе данных.

name

тип: string по умолчанию: null

Указывается имя cookie сессии. По умолчанию будет использоваться имя cookie, определённое в php.ini с директивой session.name.

cookie_lifetime

тип: integer по умолчанию: null

Определяет жизненный цикл сессии в секундах. Значение по умолчанию, null, означает, что будет использовано значение session.cookie_lifetime из php.ini. Установка этого значения, как 0, означает, что cookie валиден в течение длительности сессии браузера.

cookie_path

тип: string по умолчанию: /

Определяет путь для установки в cookie сессии. По умолчанию будет использоваться /.

cache_limiter

тип: string или int по умолчанию: ''

Если установлено, как 0, Symfony не будет устаналивать конкретный заголовок, связанный с кешем, и будет полагаться на метод контроля кеша, сконфигурированный в опции PHP.ini session.cache-limiter.

В отличие от другий опций сессии, cache_limiter установлена как обычный параметр контейнера :

1
2
3
4

# config/services.yaml
parameters:
    session.storage.options:
        cache_limiter: 0

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

<!-- config/services.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"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd">

    <parameters>
        <parameter key="session.storage.options" type="collection">
            <parameter key="cache_limiter">0</parameter>
        </parameter>
    </parameters>
</container>

1
2
3
4

// config/services.php
$container->setParameter('session.storage.options', [
    'cache_limiter' => 0,
]);

cookie_domain

тип: string по умолчанию: ''

Определяет домен для установки в cookie сессии. По умолчанию пустой, что означает, что имя хоста сервера, сгенерировавшего cookie в соответствии со спецификацией cookie.

cookie_samesite

тип: string или null по умолчанию: 'lax'

Контролирует, как отправляются куки, когда HTTP-запрос произошел не с того же домена, с которым ассоциированы куки. Установка этой опции рекомендуется для ослабления атак безопасности CSRF.

По умолчанию, браузеры отправляют все куки, связанные с доменом HTTP-запроса. Это может быть проблемой, к примеру, когда вы посещаете форум, и какой-то зловредный комментарий включает в себя ссылку вроде https://some-bank.com/?send_money_to=attacker&amount=1000. Если вы ранее выполнили вход в систему вашего сайта, браузер отправит все эти куки при совершении HTTP-запроса.

Возможные значения этой опции:

• null, используйте для отключения этой защиты. Такое же поведение, как и в более старых версиях Symfony.
• 'none' (или константа Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE), используйте для позволения отправки куки, если HTTP-запрос происходит из другого домена (ранее это было поведением по умолчанию для null, но в более новых браузерах будет применяться 'lax' , когда заголовок еще не был установлен)
• 'strict' (или константа Cookie::SAMESITE_STRICT), используйте, чтобы никогда не отправлять никаких куки, если HTTP-запрос не происходит с того же домена.
• 'lax' (или константа Cookie::SAMESITE_LAX), используйте, чтобы разрешить отправку куки, когда запрос происходит с другого домена, но только когда пользователь осознанно сделал запрос (нажав на ссылку или отправив форму с методом GET).

cookie_secure

тип: boolean или 'auto' по умолчанию: `'auto'

Определяет, должны ли куки отправляться только по защищённым связям. В дополнение к true и false, имеется специальное значение 'auto', которое означает true для HTTPS-запросов, и false для HTTP-запросов.

cookie_httponly

тип: boolean по умолчанию: true

Определяет, должны ли cookie быть доступны только через HTTP-протокол. Это означает, что cookie не будут доступны скриптовым языкам, вроде JavaScript. Эта установка может эффективно помочь снизить случаи кражи личности через XSS-атаки.

gc_divisor

тип: integer по умолчанию: 100

См. gc_probability.

gc_probability

тип: integer по умолчанию: 1

Определяет вероятность того, что процесс сбора мусора будет (СМ) начат при инициализации каждой сессии. Вероятность высчитывается с использованием gc_probability / gc_divisor, например, 1/100 означает, что есть 1% шанса, что СМ будет проводиться в каждом запросе.

gc_maxlifetime

тип: integer по умолчанию: 1440

Определяет количество секунд, после которого данные будут рассматриваться, как "мусор" и потенциально будут убраны. СМ может произойти во время начала сессии и зависит от gc_divisor и gc_probability.

sid_length

тип: integer по умолчанию: 32

Определяет длину ID строки сессии, которая может быть целым числом между 22 и 256 (включительно), где 32 - рекомендованное значение. Более длинные ID cессий сложнее угадывать.

Эта опция связана с PHP-опцией session.sid_length.

sid_bits_per_character

тип: integer по умолчанию: 4

Определяет количество битов в зашифрованном ID символе сессии. Возможные значения - 4 (0-9, a-f), 5 (0-9, a-v), и 6 (0-9, a-z, A-Z, "-", ","). Большее количество битов приводит к более крепкому ID сессии. 5 является рекомендованным значением для большинства окружений.

Эта опция связана с PHP-опцией session.sid_bits_per_character.

save_path

тип: string по умолчанию: %kernel.cache_dir%/sessions

Определяет аргумент, передаваемый обработчику сохранения. Если вы выберете обработчик файлов по умолчанию, то это путь, по которому создаются файлы сессии. Чтобы узнать больше, см Конфигурация каталога, где сохраняются файлы сессии.

Вы также можете установить это значение, как save_path вашего php.ini, установив значение, как null:

1
2
3
4

# config/packages/framework.yaml
framework:
    session:
        save_path: ~

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:session save-path="null" />
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->session()
        ->savePath(null);
};

metadata_update_threshold

тип: integer по умолчанию: 0

Это то, сколько секунд ждать между обновлением / написанием метаданных сессии. Это может быть ползено, если, по какой-то причине, вы хотите ограничить частоту, с которой сохраняется сессия, вместо того, чтобы делать это при каждом запросе.

enabled

тип: boolean по умолчанию: true

Включать ли поддержку сессии во фреймворке.

1
2
3
4

# config/packages/framework.yaml
framework:
    session:
        enabled: true

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:session enabled="true"/>
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->session()
        ->enabled(true);
};

use_cookies

тип: boolean по умолчанию: null

Указывает, хранится ID сессии на клиентской стороне, используя куки, или нет. По умолчанию, использует значение, определенное в php.ini с директивой session.use_cookies.

base_path

тип: string

Эта опция позволяет вам определять базовый путь для использования с ресурсами:

1
2
3
4
5

# config/packages/framework.yaml
framework:
    # ...
    assets:
        base_path: '/images'

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:assets base-path="/images" />
    </framework:config>
</container>

1
2
3
4
5
6
7
8

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        ->basePath('/images');
};

base_urls

тип: array

Эта опция позволяет вам определять базовые URL для использования с ресурсами. Если предоставлено несколько базовых URL, Symfony будет выбирать из коллекции один каждый раз, когда будет генерировать путь ресурса:

1
2
3
4
5
6

# config/packages/framework.yaml
framework:
    # ...
    assets:
        base_urls:
            - 'http://cdn.example.com/'

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:assets base-url="http://cdn.example.com/" />
    </framework:config>
</container>

1
2
3
4
5
6
7
8

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        ->baseUrls(['http://cdn.example.com/']);
};

packages

Вы можете группировать ресурсы в пакеты, чтобы указать для них разные базовые URL:

1
2
3
4
5
6
7

# config/packages/framework.yaml
framework:
    # ...
    assets:
        packages:
            avatars:
                base_urls: 'http://static_cdn.example.com/avatars'

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:assets>
            <framework:package
                name="avatars"
                base-url="http://static_cdn.example.com/avatars" />
        </framework:assets>
    </framework:config>
</container>

1
2
3
4
5
6
7
8
9

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        ->package('avatars')
            ->baseUrls(['http://static_cdn.example.com/avatars']);
};

Теперь вы можете использовать пакет avatars в ваших шаблонах:

1

<img src="{{ asset('...', 'avatars') }}">

Каждый пакет может сконфигурировать следующие опции:

• base_path
• base_urls
• version_strategy
• version
• version_format
• json_manifest_path
• strict_mode

version

тип: string

Эта опция используется для аннулирования кеша в ресурсах, глобально добавив параметр запроса ко всем отображённым путям ресурсов (например, /images/logo.png?v2). Это применяется только к ресурсам, отображённым через функцию Twig asset() (или PHP эквивалентом).

Например, представьте, что у вас есть следующее:

1

<img src="{{ asset('images/logo.png') }}" alt="Symfony!"/>

По умолчанию, это отобразит путь к вашему изображению так: /images/logo.png. Теперь, активируйте опцию version:

1
2
3
4
5

# config/packages/framework.yaml
framework:
    # ...
    assets:
        version: 'v2'

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:assets version="v2"/>
    </framework:config>
</container>

1
2
3
4
5
6
7
8

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        ->version('v2');
};

Теперь, тот же ресерс будет отображаться, как /images/logo.png?v2. Если вы используете эту функцию, вы должны вручную увеличить значение version до каждого развёртывания, чтобы параметры запросов изменялись.

Вы также можете контролировать то, как работает строка запросов, через опцию version_format.

version_format

тип: string по умолчанию: %%s?%%s

Определяет схему sprintf, которая будет использована опцией version, чтобы построить путь ресурса. По умолчанию, схема добавляется к версии ресурса в качестве строки запроса Например, если version_format установлен, как %%s?version=%%s, а version - как 5, то путь ресурса будет /images/logo.png?version=5.

version_strategy

тип: string по умолчанию: null

Id сервиса стратегии версий ресурсов применяется к ресурсам. Эта опция может быть установлена глоабльно для всех ресурсов, и индивидуально для каждого пакета ресурсов:

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

# config/packages/framework.yaml
framework:
     assets:
         # эта стратегия применяется к каждому ресурсу (включая пакеты)
         version_strategy: 'app.asset.my_versioning_strategy'
         packages:
             foo_package:
                 # этот пакет удаляет всё версионирование (его ресурсы не будут версионированы)
                 version: ~
             bar_package:
                 # этот пакет использует свою собственную стратегию (стратегия по умолчанию игнорируется)
                 version_strategy: 'app.asset.another_version_strategy'
             baz_package:
                 # этот пакет наследует стратегию по умолчанию
                 base_path: '/images'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:assets version-strategy="app.asset.my_versioning_strategy">
            <!-- этот пакет удаляет всё версионирование (его ресурсы не будут версионированы) -->
            <framework:package
                name="foo_package"
                version="null" />
            <!-- этот пакет использует свою собственную стратегию (стратегия по умолчанию игнорируется) -->
            <framework:package
                name="bar_package"
                version-strategy="app.asset.another_version_strategy" />
            <!-- этот пакет наследует стратегию по умолчанию -->
            <framework:package
                name="baz_package"
                base_path="/images" />
        </framework:assets>
    </framework:config>
</container>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        ->versionStrategy('app.asset.my_versioning_strategy');

    $framework->assets()->package('foo_package')
        // этот пакет удаляет всё версионирование (его ресурсы не будут версионированы)
        ->version(null);

    $framework->assets()->package('bar_package')
        // этот пакет использует свою собственную стратегию (стратегия по умолчанию игнорируется)
        ->versionStrategy('app.asset.another_version_strategy');

    $framework->assets()->package('baz_package')
        // этот пакет наследует стратегию по умолчанию
        ->basePath('/images');
};

json_manifest_path

тип: string по умолчанию: null

Путь файла к файлу manifest.json, содержащему ассоциативный массив имён ресурсов и их соответствующих скомпилированных имён. Распространённая техника сброса кеша, используя файл "manifest", работает путём выписывания ресурсов с префиксом "hash" в их именах файлов (например, main.ae433f1cb.css) во время процесса фронт-энд компиляции.

Эта опция может быть установлена глобально для всех ресурсов и индивидуально для каждого пакета ресурса:

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

# config/packages/framework.yaml
framework:
    assets:
        # этот манифест применяется к каждому ресурсу (включая пакеты)
        json_manifest_path: "%kernel.project_dir%/public/build/manifest.json"
        # вы также можете использовать абсолютные URL, и Symfony скачает их автоматически
        # json_manifest_path: 'https://cdn.example.com/manifest.json'
        packages:
            foo_package:
                # этот пакет использует собственный манифест (файл по умолчанию игнорируется)
                json_manifest_path: "%kernel.project_dir%/public/build/a_different_manifest.json"
            bar_package:
                # этот пакет использует глобальный манифест (файл по умолчанию используется)
                base_path: '/images'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <!-- этот манифест применяется к каждому ресурсу (включая пакеты) -->
        <framework:assets json-manifest-path="%kernel.project_dir%/public/build/manifest.json">
        <!-- вы также можете использовать абсолютные URL, и Symfony скачает их автоматически -->
        <!-- <framework:assets json-manifest-path="https://cdn.example.com/manifest.json"> -->
            <!-- этот пакет использует собственный манифест (файл по умолчанию игнорируется) -->
            <framework:package
                name="foo_package"
                json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json"/>
            <!-- этот пакет использует глобальный манифест (файл по умолчанию используется) -->
            <framework:package
                name="bar_package"
                base-path="/images"/>
        </framework:assets>
    </framework:config>
</container>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    // ...
    $framework->assets()
        // этот манифест применяется к каждому ресурсу (включая пакеты)
        ->jsonManifestPath('%kernel.project_dir%/public/build/manifest.json');

    // вы также можете использовать абсолютные URL, и Symfony скачает их автоматически
    // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
    $framework->assets()->package('foo_package')
        // этот пакет использует собственный манифест (файл по умолчанию игнорируется)
        ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json');

    $framework->assets()->package('bar_package')
        // этот пакет использует глобальный манифест (файл по умолчанию используется)
        ->basePath('/images');
};

strict_mode

тип: boolean по умолчанию: false

Когда включен, строгий режим утверждает, что все запрошенные ресурсы находятся в файле манифеста. Эта опция полезна для обнаружения опечаток или недостающих ресурсов, рекомендованное значение - %kernel.debug%.

cache_dir

тип: string | null по умолчанию: %kernel.cache_dir%/translations/

Определяет каталог, где хранится кеш перевода. Используйте null, чтобы отключить этот кеш.

enabled

тип: boolean по умолчанию: true или false, в зависимости от вашей установки

Подключать ли сервис translator в сервис-контейнере.

fallbacks

тип: string|array по умолчанию: значение default_locale

Эта опция используется, когда ключ перевода для текущей локали не был найден.

logging

по умолчанию: true когда включен режим отладки, false - когда нет.

Когда true, то запись логов делается каждый раз, когда переводчик не может найти перевод для заданного ключа. Логи делаются в канале translation и на в уровне debug для ключей, когда в резервной локали есть перевод, и на уровне warning, если нет перевода для использования.

formatter

тип: string по умолчанию: translator.formatter.default

ID сервиса, используемого для форматирования сообщений перевода. Класс сервиса должен реализовать MessageFormatterInterface.

paths

тип: array по умолчанию: []

Эта опция позволяет определить массив путей, где компонент будет искать файлы перевода. Чем позже будет добавлен путь, тем большую приоритетность он будет иметь (переводы из более поздних путей будут перезаписивать более раниие). Переводы из default_path имеют больший приоритет, чем переводы из всех этих путей.

default_path

тип: string по умолчанию: %kernel.project_dir%/translations

Эта опция позволяет определять путь, где хранятся файлы переводов приложения.

providers

тип: array по умолчанию: []

Эта опция включает и конфигурирует поставщиков переводов , чтобы пушить и пуллить ваши переводы из/в сторонние сервисы перевода.

magic_call

тип: boolean по умолчанию: false

Когда включена, сервис property_accessor использует PHP метод magic __call() . когда вызывается его метод getValue().

magic_get

тип: boolean по умолчанию: true

Когда включена, сервис property_accessor использует PHP метод magic __get() , когда вызывается его метод getValue().

magic_set

тип: boolean по умолчанию: true

Когда включена, сервис property_accessor использует PHP метод magic __set() , когда вызывается его метод setValue().

throw_exception_on_invalid_index

тип: boolean по умолчанию: false

Когда включена, сервис property_accessor вызывает исключение, когда вы пробуете получить доступ к невалидному индексу массива.

throw_exception_on_invalid_property_path

тип: boolean по умолчанию: true

Когда включена, сервис property_accessor вызывает исключение, если вы пытаетесь получить доступ к невалидному пути свойства объекта.

enabled

тип: boolean по умолчанию: true или false, взависимости от вашей установки

enabled

тип: boolean по умолчанию: true или false, в зависимости от вашей установки

Включать поддержку валидации, или нет.

Эта опция будет автоматически установлена, как true, когда конфигурируется одна из дочерних настроек.

enable_annotations

тип: boolean по умолчанию: false

Если эта опция включена, ограничения валидации могут быть определены с использованием аннотаций.

translation_domain

тип: string | false по умолчанию: validators

Домен переводов, используемый при переводе сообщений ошибок ограничений валидации. Используйте false, чтобы отключить переводы.

not_compromised_password

Ограничение NotCompromisedPassword делает HTTP-запросы к публичному API, чтобы проверить, был ли заданный пароль скомпроментирован при утечке данных.

static_method

тип: string | array по умолчанию: ['loadValidatorMetadata']

Определяет имя статического метода, который вызывается для загрузки метаданных валидации класса. Вы можете определить массив строк с именами нескольких методов. В таком случае, они все будут вызваны по порядку, чтобы загрузить метаданные.

email_validation_mode

тип: string по умолчанию: loose

Устанавливает значение по умолчанию для опции "mode" для валидатора Email .

mapping

1
2
3
4
5
6

# config/packages/framework.yaml
framework:
    validation:
        mapping:
            paths:
                - "%kernel.project_dir%/config/validation/"

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:validation>
            <framework:mapping>
                <framework:path>%kernel.project_dir%/config/validation/</framework:path>
            </framework:mapping>
        </framework:validation>
    </framework:config>
</container>

1
2
3
4
5
6
7
8

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->validation()
        ->mapping()
            ->paths(['%kernel.project_dir%/config/validation/']);
};

cache

тип: string по умолчанию: 'php_array'

Эта опция может быть одним из следующих значений:

php_array

Использовать PHP-массив, чтобы кешировать аннотации в памяти

file

Использовать файловую систему для кеширования аннотаций

none

Отключить кеширование аннотаций

service id

id сервиса, ссылающийся на реализацию Кеша Doctrine

file_cache_dir

тип: string по умолчанию: '%kernel.cache_dir%/annotations'

Каталог для хранения файлов кеша для аннотаций, в случае, если annotations.cache установлен, как 'file'.

debug

тип: boolean по умолчанию: %kernel.debug%

Включать режим отладки для кеширования, или нет. Если включен, то кеш будет автоматически обновлён, когда изменяется исходный файл (с изменениями и кода и аннотации). По причинам производительности, рекомендуется отключать режим отладки в производстве, что случится автоматически, если вы используете значение по умолчанию.

decryption_env_var

тип: string по умолчанию: base64:default::SYMFONY_DECRYPTION_SECRET

Переменная окружения, которая содержит ключ дешифровки.

local_dotenv_file

тип: string по умолчанию: %kernel.project_dir%/.env.%kernel.environment%.local

Путь к файлу dotenv, хранящему секреты. В основном используется для тестирования.

vault_directory

тип: string по умолчанию: %kernel.project_dir%/config/secrets/%kernel.environment%

Каталог, где хранится хранилище секретов.

enabled

тип: boolean по умолчанию: true или false, в зависимости от вашей установки

Включать сервис serializer в сервис-контейнере, или нет.

enable_annotations

тип: boolean по умолчанию: false

Если эта опция включен, группы сериализации могут быть определены с использованием аннотаций.

name_converter

тип: string

Конвертер имён для использования. Конвертер имён CamelCaseToSnakeCaseNameConverter может быть включен, используя значение serializer.name_converter.camel_case_to_snake_case.

circular_reference_handler

тип string

Id сервиса, который используется как обработчик циклической зависимоти сериализатора по умолчанию. Сервис должен реализовывать волшебный метод __invoke($object).

mapping

default_context

тип: array по умолчанию: []

Карта с опциями контекста по умолчанию, которые будут использованы с каждым вызовом serialize и deserialize. Это может быть использовано, к примеру, для установки поведения шифрования json, путём установки json_encode_options как json_encode flags bitmask.

Вы можете изучить конструкторы контекста сериализатора , чтобы узнать о доступных настройках.

log

тип: boolean|int по умолчанию: %kernel.debug%

Использовать логгер приложения вместо PHP-логгера для логирования PHP-ошибок. Когда используется значение целого числа, оно также устанавливает уровень логов. Эти значения целых чисел должны быть такими же, как используются в error_reporting PHP option.

Эта опция также принимает отображнение PHP-ошибок, чтобы вести логи уровней:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# config/packages/framework.yaml
framework:
    php_errors:
        log:
            '!php/const \E_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_USER_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_NOTICE': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_USER_NOTICE': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_STRICT': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_WARNING': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_USER_WARNING': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_COMPILE_WARNING': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_CORE_WARNING': !php/const Psr\Log\LogLevel::ERROR
            '!php/const \E_USER_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
            '!php/const \E_RECOVERABLE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
            '!php/const \E_COMPILE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
            '!php/const \E_PARSE': !php/const Psr\Log\LogLevel::CRITICAL
            '!php/const \E_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
            '!php/const \E_CORE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL

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

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <!-- в конфигурации XML вы можете использовать PHP-константы в качестве значения
             атрибута 'type', что делает данный формат намного менее читаемым.
             Рассматрите использование YAML или PHP для этой конфигурации -->
        <framework:log type="8" logLevel="error"/>
        <framework:log type="2" logLevel="error"/>
        <!-- ... -->
    </framework:config>
</container>

1
2
3
4
5
6
7
8
9

// config/packages/framework.php
use Psr\Log\LogLevel;
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
    $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
    // ...
};

throw

тип: boolean по умолчанию: %kernel.debug%

Вызывает PHP-ошибки, как экземпляры \ErrorException. Параметр debug.error_handler.throw_at контролирует порог.

app

тип: string по умолчанию: cache.adapter.filesystem

Адаптер кеша, используемый сервисом cache.app. FrameworkBundle поставляется с несколькими адаптерами: cache.adapter.apcu, cache.adapter.doctrine, cache.adapter.system, cache.adapter.filesystem, cache.adapter.psr6, cache.adapter.redis, cache.adapter.memcached и cache.adapter.pdo.

Также сущетвует специальный адаптер под названием cache.adapter.array, который хранит содержимое памяти, используя PHP массив и используется для отключения кеширования (в основном в окружении dev).

system

тип: string по умолчанию: cache.adapter.system

Адаптер кеша, ипользуемый сервисом cache.system. Он поддерживает те же адаптеры, что доступны для сервиса cache.app.

directory

тип: string по умолчанию: %kernel.cache_dir%/pools

Путь к каталогу кеша, используемый сервисами, наследующими из адаптера cache.adapter.filesystem (включая cache.app).

default_doctrine_provider

тип: string

Имя сервиса для использования в качестве вашего поставщика Doctrine по умолчанию. Поставщик доступен в качестве сервиса cache.doctrine.

default_psr6_provider

тип: string

Имя сервиса для использования в качестве вашего поставщика PSR-6 по умолчанию. Он доступен в качестве сервиса cache.psr6.

default_redis_provider

тип: string по умолчанию: redis://localhost

DSN для использования поставщиком Redis. Поставщик доступен в качестве сервиса cache.redis.

default_memcached_provider

тип: string по умолчанию: memcached://localhost

DSN для использования провайдером Memcached. Провайдер доступен в качестве сервиса cache.memcached.

default_pdo_provider

тип: string по умолчанию: doctrine.dbal.default_connection

Id сервиса соединения базы данных, который должен быть либо экземпляром PDO, либо Doctrine DBAL. Поставщик доступен как сервис cache.default_pdo_provider.

pools

тип: array

Список пулов кеша, который должен быть создан расширением фреймворка.

Чтобы сконфигурировать пул кеша Redis с циклом жизни в 1 час, сделайте следующее:

1
2
3
4
5
6
7

# config/packages/framework.yaml
framework:
    cache:
        pools:
            cache.mycache:
                adapter: cache.adapter.redis
                default_lifetime: 3600

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

<!-- config/packages/framework.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:cache>
            <framework:pool
                name="cache.mycache"
                adapter="cache.adapter.redis"
                default-lifetime="3600"
            />
        </framework:cache>
        <!-- ... -->
    </framework:config>
</container>

1
2
3
4
5
6
7
8
9

// config/packages/framework.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->cache()
        ->pool('cache.mycache')
            ->adapters(['cache.adapter.redis'])
            ->defaultLifetime(3600);
};

prefix_seed

тип: string по умолчанию: _%kernel.project_dir%.%kernel.container_class%

Это значеиие используется в качестве части "пространства имён", сгенерированного для ключей объектов кеша. Частая практика - использовать уникальное имя приложения (например, symfony.com), так как это предотвращает конфликты именования при запуске нескольких приложений по одному пути (на разных серверах), которые используют одинаковый бэк-энд кеша.

Это также полезно при использовании стратегий синего/зелёного запуска и даже чаще, когда вам нужно абстрагироваться от настоящего каталога развёртывания (например, при разогрефе кеша офлайн).

enabled

тип: boolean default: true

Включать поддержку блокировки или нет. Эта настйрока автоматически установлена, как true, если сконфигурирована одна из дочерних настроейк.

resources

тип: array

Список хранилищ блокировок, которые должны быть созданы расширением фреймворка.

1
2
3

# config/packages/lock.yaml
framework:
    lock: '%env(LOCK_DSN)%'

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

<!-- config/packages/lock.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:lock>
            <framework:resource>%env(LOCK_DSN)%</framework:resource>
        </framework:lock>
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/lock.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->lock()
        ->resource('default', ['%env(LOCK_DSN)%']);
};

enabled

тип: boolean по умолчанию: true

Включать ли поддержку семфоров. Эта установка автоматически имеет значение true, если не сконфигурирована хоть одна из дочерних настроек.

resources

тип: array

Карта хранилищ семафоров, которую нужно создать расширением фреймворка, с именем как ключом, а DSN как значением:

1
2
3

# config/packages/semaphore.yaml
framework:
    semaphore: '%env(SEMAPHORE_DSN)%'

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

<!-- config/packages/semaphore.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">

    <framework:config>
        <framework:semaphore>
            <framework:resource name="default">%env(SEMAPHORE_DSN)%</framework:resource>
        </framework:semaphore>
    </framework:config>
</container>

1
2
3
4
5
6
7

// config/packages/semaphore.php
use Symfony\Config\FrameworkConfig;

return static function (FrameworkConfig $framework) {
    $framework->semaphore()
        ->resource('default', ['%env(SEMAPHORE_DSN)%']);
};

dsn

тип: string по умолчанию: null

DSN, используемая почтовой программой. Когда могут быть использованы несколько DSN, стоит использовать опцию transports (см. ниже).

transports

тип: array

Список DSN , которые могут быть использованы почтовой программой. Имя транспорта является ключом, а dsn - значением.

message_bus

тип: string по умолчанию: null или автобус по умолчанию, если установлен компонент Messenger

Сервичный идентификатор автобуса сообщений, который нужно использовать при импользовании компонента Messenger (например, messenger.default_bus).

envelope

1
2
3
4
5
6

# config/packages/mailer.yaml
framework:
    mailer:
        dsn: 'smtp://localhost:25'
        envelope:
            recipients: ['admin@symfony.com', 'lead@symfony.com']

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

<!-- config/packages/mailer.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:framework="http://symfony.com/schema/dic/symfony"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    <framework:config>
        <framework:mailer dsn="smtp://localhost:25">
            <framework:envelope>
                <framework:recipient>admin@symfony.com</framework:recipient>
                <framework:recipient>lead@symfony.com</framework:recipient>
            </framework:envelope>
        </framework:mailer>
    </framework:config>
</container>

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

// config/packages/mailer.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

return static function (ContainerConfigurator $containerConfigurator): void {
    $containerConfigurator->extension('framework', [
        'mailer' => [
            'dsn' => 'smtp://localhost:25',
            'envelope' => [
                'recipients' => [
                    'admin@symfony.com',
                    'lead@symfony.com',
                ],
            ],
        ],
    ]);
};

headers

тип: array

Заголовки, которые нужно добавить к письмам. Ключ (атрибут name в xml-формате) - это имя заголовка, а значение - значение заголовка.

enabled

тип: boolean по умолчанию: true или false, в зависимости от вашей установки

Добавляет к ответу HTTP-заголовок Link.

enabled

тип: boolean default: false

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

name

тип: prototype

Имя рабочего процесса, который вы хотите создать.