Файлы конфигурации

Приложения Symfony сконфигурированы с файлами, хранящимися в каталоге config/, который по умолчанию имеет следующую структуру:

1
2
3
4
5
6
7

your-project/
├─ config/
│  ├─ packages/
│  ├─ bundles.php
│  ├─ routes.yaml
│  └─ services.yaml
├─ ...

Файл routes.yaml определяет конфигурацию маршрутизации; файл services.yaml конфигурирует сервисы сервис-контейнера; файл bundles.php включает/ выключает пакеты в вашем приложении.

Вы будете в основном работать в каталоге config/packages/. Этот каталог сохраняет конфигурацию каждого пакета, установленного в вашем приложении. Пакеты (которые также называются "плагины/модули" в других проектах) добавляют готовые к использованию функции в ваши проекты.

При использовании Symfony Flex , который в приложениях Symfony включен по умолчанию, пакеты обновляют файл bundles.php и создают новые файлы в config/packages/ автоматически во время установки. К примеру, это файл по умолчанию, созданный пакетом "API Platform":

1
2
3
4

# config/packages/api_platform.yaml
api_platform:
    mapping:
        paths: ['%kernel.project_dir%/src/Entity']

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

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

# config/services.yaml
imports:
    - { resource: 'legacy_config.php' }

    # глобальные выражения также поддерживают загрузку нескольких файлов
    - { resource: '/etc/myapp/*.yaml' }

    # ignore_errors: not_found тихо удаляет ошибки в случае если загруженный файл не существует
    - { resource: 'my_config_file.xml', ignore_errors: not_found }
    # ignore_errors: true тихо удаляет все ошибки (включая неверный код и не найдено)
    - { resource: 'my_other_config_file.xml', ignore_errors: true }

# ...

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

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

    <imports>
        <import resource="legacy_config.php"/>
        <!-- глобальные выражения также поддерживают загрузку нескольких файлов -->
        <import resource="/etc/myapp/*.yaml"/>

        <!-- ignore-errors="not_found" тихо удаляет ошибки в случае если загруженный файл не существует -->
        <import resource="my_config_file.yaml" ignore-errors="not_found"/>
        <!-- ignore-errors="true" тихо удаляет все ошибки (включая неверный код и не найдено) -->
        <import resource="my_other_config_file.yaml" ignore-errors="true"/>
    </imports>

    <!-- ... -->
</container>

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

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

return static function (ContainerConfigurator $container) {
    $container->import('legacy_config.php');

    // глобальные выражения также поддерживают загрузку нескольких файлов
    $container->import('/etc/myapp/*.yaml');

    // the third optional argument of import() is 'ignore_errors'
    // 'ignore_errors' установленный как 'not_found' silently тихо удаляет ошибки в случае если загруженный файл не существует
    $container->import('my_config_file.yaml', null, 'not_found');
    // 'ignore_errors' тихо удаляет все ошибки (включая неверный код и не найдено)
    $container->import('my_config_file.yaml', null, true);
};

// ...

Параметры конфигурации

Иногда одино и то же значение конфигурации используется в нескольких файлах конфигурации. Вместо его повторения, вы можете определить его как "параметр", что является чем-то вроде повторно используемого значения конфигурации. По соглашению, параметры определяются под ключом parameters в файле config/services.yaml:

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

# config/services.yaml
parameters:
    # имя параметра - произвольная строка (рекомендуется префикс 'app.'
    # для лучшей дифференциации ваших параметров от параметров Symfony).
    app.admin_email: 'something@example.com'

    # булевы параметры
    app.enable_v2_protocol: true

    # параметры массива/коллекции
    app.supported_locales: ['en', 'es', 'fr']

    # параметры бинарного содержания (зашифруйте его с помощью base64_encode())
    app.some_parameter: !!binary VGhpcyBpcyBhIEJlbGwgY2hhciAH

    # PHP-константы в качестве значений параметра
    app.some_constant: !php/const GLOBAL_CONSTANT
    app.another_constant: !php/const App\Entity\BlogPost::MAX_ITEMS

# ...

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
26
27
28
29
30
31
32
33
34
35
36
37

<!-- 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"
    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">

    <parameters>
        <!-- имя параметра - произвольная строка (рекомендуется префикс 'app.'
             для лучшей дифференциации ваших параметров от параметров Symfony). -->
        <parameter key="app.admin_email">something@example.com</parameter>

        <!-- булевы параметры -->
        <parameter key="app.enable_v2_protocol">true</parameter>
        <!-- if you prefer to store the boolean value as a string in the parameter -->
        <parameter key="app.enable_v2_protocol" type="string">true</parameter>

        <!-- параметры массива/коллекции -->
        <parameter key="app.supported_locales" type="collection">
            <parameter>en</parameter>
            <parameter>es</parameter>
            <parameter>fr</parameter>
        </parameter>

        <!-- параметры бинарного содержания (зашифруйте его с помощью base64_encode()) -->
        <parameter key="app.some_parameter" type="binary">VGhpcyBpcyBhIEJlbGwgY2hhciAH</parameter>

        <!-- PHP-константы в качестве значений параметра -->
        <parameter key="app.some_constant" type="constant">GLOBAL_CONSTANT</parameter>
        <parameter key="app.another_constant" type="constant">App\Entity\BlogPost::MAX_ITEMS</parameter>
    </parameters>

    <!-- ... -->
</container>

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
26

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

use App\Entity\BlogPost;

return static function (ContainerConfigurator $container) {
    $container->parameters()
        // имя параметра - произвольная строка (рекомендуется префикс 'app.'
        // для лучшей дифференциации ваших параметров от параметров Symfony).
        ->set('app.admin_email', 'something@example.com')

        // булевы параметры
        ->set('app.enable_v2_protocol', true)

        // параметры массива/коллекции
        ->set('app.supported_locales', ['en', 'es', 'fr'])

        // параметры бинарного содержания (используйте упряаляющие последовательности PHP)
        ->set('app.some_parameter', 'This is a Bell char: \x07')

        // PHP-константы в качестве значений параметра
        ->set('app.some_constant', GLOBAL_CONSTANT)
        ->set('app.another_constant', BlogPost::MAX_ITEMS);
};

// ...

1
2
3

<parameter key="app.admin_email">
    something@example.com
</parameter>

Когда он будет определен, вы можете сослаться на значение этого парамтера из любого другого файла конфигурации, используя специальный синтаксис: оберните имя параметра в два % (например, %app.admin_email%):

1
2
3
4
5
6

# config/packages/some_package.yaml
some_package:
    # любая строка, окруженная двумя %, заменяется этим значением параметра
    email_address: '%app.admin_email%'

    # ...

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

<!-- config/packages/some_package.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">

    <!-- любая строка, окруженная двумя %, заменяется этим значением параметра -->
    <some-package:config email-address="%app.admin_email%">
        <!-- ... -->
    </some-package:config>
</container>

1
2
3
4
5
6
7
8
9
10
11

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

return static function (ContainerConfigurator $container) {
    $container->extension('some_package', [
        // любая строка, окруженная двумя %, заменяется этим значением параметра
        'email_address' => '%app.admin_email%',

        // ...
    ]);
};

1
2
3
4

# config/services.yaml
parameters:
    # Parsed as 'https://symfony.com/?foo=%s&bar=%d'
    url_pattern: 'https://symfony.com/?foo=%%s&bar=%%d'

1
2
3
4

<!-- config/services.xml -->
<parameters>
    <parameter key="url_pattern">http://symfony.com/?foo=%%s&amp;bar=%%d</parameter>
</parameters>

1
2
3
4
5
6
7

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

return static function (ContainerConfigurator $container) {
    $container->parameters()
        ->set('url_pattern', 'http://symfony.com/?foo=%%s&bar=%%d');
};

Дата обновления перевода 2023-01-20

1
2
3

# config/services.yaml
imports:
    - { resource: '%kernel.project_dir%/somefile.yaml' }

1
2
3
4
5
6
7
8
9
10
11

<!-- 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"
>
    <imports>
        <import resource="%kernel.project_dir%/somefile.yaml"/>
    </imports>
</container>

1
2
3
4
5
6

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

return static function (ContainerConfigurator $container) {
    $container->import('%kernel.project_dir%/somefile.yaml');
};

Параметры конфигурации очень распространены в приложениях Symfony. Некоторые пакет даже определяют свои собственные параметры (например, при установке пакета переводов, в файл config/services.yaml добавляется новый параметр locale).

Окружения конфигурации

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

• Во время разработки, вам нужно вести логи всего и иметь хорошие инструменты отладки;
• После запуска в производство, вам нужно, чтобы то же приложение было оптимизировано для скорости и вело лог только для ошибок.

Файлы, хранящиеся в config/packages/ используются Symfony для конфигурации сервисов приложения. Другими словами, вы можете изменить поведение приложения, изменив то, какие файлы конфигурации загружаются. В этом заключается идея окружений конфигурации Symfony.

Типичное приложение Symfony начинается с трех окружений: dev (для локальной разработки), prod (для производственных серверов) м test (для автоматизированных тестов). При запуске приложения Symfony загружает файлы конфигурации в этом порядке (последние файлы могут переопределить значения, установленные в предыдущих):

1. config/packages/*.yaml (а также файлы *.xml и *.php);
2. config/packages/<environment-name>/*.yaml (а также файлы *.xml и *.php);
3. config/services.yaml (а также файлы services.xml и services.php);
4. config/services_<environment-name>.yaml (а также файлы services_<environment-name>.xml и services_<environment-name>.php).

Возьмем пакет framework, установленный по умолчанию, в качетве примера:

• Вначале загружается config/packages/framework.yaml во всех окружениях и конфигурирует фреймворк с некоторыми опциями;
• В окружении prod не будет установлено ничего дополнительного, так как нет файла config/packages/prod/framework.yaml;
• В окружении dev, также нет файла ( config/packages/dev/framework.yaml не существует).
• В окружении test, файл config/packages/test/framework.yaml загружается для переопределения некоторых из настроек, ранее сконфигурированных в config/packages/framework.yaml.

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

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

# config/packages/webpack_encore.yaml
webpack_encore:
    # ...
    output_path: '%kernel.project_dir%/public/build'
    strict_mode: true
    cache: false

# кеш включен только в окружении "prod"
when@prod:
    webpack_encore:
        cache: true

# отключить строгий режим только в окружении "test"
when@test:
    webpack_encore:
        strict_mode: false

# синтаксис YAML позволяет повторно использовать содержание, используя "якори" (&some_name) и "псевдонимы" (*some_name).
# В этом примере, конфигурация 'test' использует точно такую же конфигурацию, как в 'prod'
when@prod: &webpack_prod
    webpack_encore:
        # ...
when@test: *webpack_prod

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/webpack_encore.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
        http://symfony.com/schema/dic/symfony
        https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
    <webpack-encore:config
        output-path="%kernel.project_dir%/public/build"
        strict-mode="true"
        cache="false"
    />

    <!-- кеш включен только в окружении "prod" -->
    <when env="prod">
        <webpack-encore:config cache="true"/>
    </when>

    <!-- отключить строгий режим только в окружении "test" -->
    <when env="test">
        <webpack-encore:config strict-mode="false"/>
    </when>
</container>

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

// config/packages/framework.php
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
use Symfony\Config\WebpackEncoreConfig;

return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container) {
    $webpackEncore
        ->outputPath('%kernel.project_dir%/public/build')
        ->strictMode(true)
        ->cache(false)
    ;

    // кеш включен только в окружении "prod"
    if ('prod' === $container->env()) {
        $webpackEncore->cache(true);
    }

    // отключить строгий режим только в окружении "test"
    if ('test' === $container->env()) {
        $webpackEncore->strictMode(false);
    }
};

1
2

# .env (или .env.local)
APP_ENV=prod

1
2
3
4
5

# Используйте окружение, определенное в файле .env
$ php bin/console command_name

# Игнорируйте файл .env file и выполните эту команду в производстве
$ APP_ENV=prod php bin/console command_name

Конфигурация, основанная на переменных окружаения

Использование переменных окружения (или сокращенно "env vars") - это распространенная практика для конфигурации опций, которые зависят от того, где запускается приложение (например, идентификационные данные БД обычно отличаются в производстве и на вашей локальной машине). Если значения чувствительны, вы даже можете зашифровать из как секретные.

Вы можете ссолаться на переменные окружения используя специальный синтаксис %env(ENV_VAR_NAME)%. Значения этих опций разрешаются во время выполнения (только единожды за запрос, чтобы не повлиять на производительность).

Этот пример показывает, как вы можете сконфигурировать соединение БД, используя переменную окружения:

1
2
3
4
5
6

# config/packages/doctrine.yaml
doctrine:
    dbal:
        # по соглашению имена переменных окружений всегда используют верхний регистр
        url: '%env(resolve:DATABASE_URL)%'
    # ...

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

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

    <doctrine:config>
        <!-- по соглашению имена переменных окружений всегда используют верхний регистр -->
        <doctrine:dbal url="%env(resolve:DATABASE_URL)%"/>
    </doctrine:config>

</container>

1
2
3
4
5
6
7
8
9
10
11

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

return static function (ContainerConfigurator $container) {
    $container->extension('doctrine', [
        'dbal' => [
            // по соглашению имена переменных окружений всегда используют верхний регистр
            'url' => '%env(resolve:DATABASE_URL)%',
        ]
    ]);
};

Чтобы определить значение любой переменной окружения, у вас есть несколько вариантов:

• Добавить значение к файлу .env ;
• Зашифровать значение как секрет ;
• Установить значение как реальную переменную окружения в вашей оболочке или веб-сервере.

1
2

# .env
DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name"

1
2
3

# database credentials
DB_USER=root
DB_PASS=pass # это секретный пароль

1
2

DB_USER=root
DB_PASS=${DB_USER}pass # добавьте пользователя в качестве префикса пароля

1
2

DB_USER=
DB_PASS=${DB_USER:-root}pass # приводит к DB_PASS=rootpass

1

START_TIME=$(date)

1

$ source .env

1
2

# .env.local
DATABASE_URL="mysql://root:@127.0.0.1:3306/my_database_name"

1
2

# анализирует ВСЕ файлы .env и сбрасывает их финальные значения в .env.local.php
$ composer dump-env prod

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
26

$ php bin/console debug:dotenv

Dotenv переменные & файлы
=========================

Просканированные файлы (в порядке снижения приоритета)
------------------------------------------------------

* ⨯ .env.local.php
* ⨯ .env.dev.local
* ✓ .env.dev
* ⨯ .env.local
* ✓ .env

Переменные
----------

------------ ---------- ---------- ------
 Переменная   Значение   .env.dev   .env
------------ ---------- ---------- ------
 FOO          BAR        n/a        BAR
 ALICE        BOB        BOB        bob
------------ ---------- ---------- ------

# искать конкретную переменную, передавая её полное или частичное имя в качестве аргумента
$ php bin/console debug:dotenv foo

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

$ php bin/console debug:container --env-vars

---------------- ---------------------- ---------------------------------------------
 Имя             Значение по умолчанию  Реальное значение
---------------- ---------------------- ---------------------------------------------
 APP_SECRET       недоступно            "471a62e2d601a8952deb186e44186cb3"
 FOO              "[1, "2.5", 3]"       n/a
 BAR              null                  n/a
---------------- ---------------------- ---------------------------------------------

# вы также можете отфильтровать список env vars по имени:
$ php bin/console debug:container --env-vars foo

# выполните эту команду, чтобы показать все детали для конкретного env var:
$ php bin/console debug:container --env-var=FOO

Доступ к параметрам конфигурации

Контроллеры и сервисы могут получить доступ ко всем параметрам конфигурации. Это включает в себя как параметры, определенные вами defined by yourself , так и параметры, созданные пакетами. Выполните следующую команду, чтобы увидеть все параметры, существующие в вашем приложении:

1

$ php bin/console debug:container --parameters

В контроллерах, расщиряющихся из AbstractController , используйте хелпер getParameter():

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

// src/Controller/UserController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class UserController extends AbstractController
{
    // ...

    public function index(): Response
    {
        $projectDir = $this->getParameter('kernel.project_dir');
        $adminEmail = $this->getParameter('app.admin_email');

        // ...
    }
}

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

1
2
3
4
5
6
7
8

# config/services.yaml
parameters:
    app.contents_dir: '...'

services:
    App\Service\MessageGenerator:
        arguments:
            $contentsDir: '%app.contents_dir%'

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

<!-- 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="app.contents_dir">...</parameter>
    </parameters>

    <services>
        <service id="App\Service\MessageGenerator">
            <argument key="$contentsDir">%app.contents_dir%</argument>
        </service>
    </services>
</container>

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

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

use App\Service\MessageGenerator;

return static function (ContainerConfigurator $container) {
    $container->parameters()
        ->set('app.contents_dir', '...');

    $container->services()
        ->get(MessageGenerator::class)
            ->arg('$contentsDir', '%app.contents_dir%');
};

Если вы будете внедрять одни и те же параметры снова и снова, используйте вместо этого опцию services._defaults.bind. Аргументы, определенные в этой опции, внедряются автоматически каждый раз, когда конструктор сервиса или действие контроллера определяет аргумент с точно таким же именем. Например, чтобы внедрять значение параметра kernel.project_dir , каждый раз, когда сервис/контроллер определяет аргумент $projectDir, используйте это:

1
2
3
4
5
6
7
8
9

# config/services.yaml
services:
    _defaults:
        bind:
            # передайте это значение любому аргументу $projectDir для любого сервиса,
            # созданного в этом файле (включая аргументы контроллера)
            $projectDir: '%kernel.project_dir%'

    # ...

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

<!-- 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">

    <services>
        <defaults autowire="true" autoconfigure="true" public="false">
            <!-- передайте это значение любому аргументу $projectDir для любого сервиса,
                 созданного в этом файле (включая аргументы контроллера) -->
            <bind key="$projectDir">%kernel.project_dir%</bind>
        </defaults>

        <!-- ... -->
    </services>
</container>

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

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

use App\Controller\LuckyController;

return static function (ContainerConfigurator $container) {
    $container->services()
        ->defaults()
            // передайте это значение любому аргументу $projectDir для любого сервиса,
            // созданного в этом файле (включая аргументы контроллера)
            ->bind('$projectDir', '%kernel.project_dir%');

    // ...
};

Наконец, если какому-то сервису нужен доступ ко множеству параметров, вместо внедрения каждого из них отдельно, вы можете внедрить все параметры приложения одномоментно добавив подсказки при вводе кода к любому из аргументов конструктора с ContainerBagInterface:

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

// src/Service/MessageGenerator.php
namespace App\Service;

// ...

use Symfony\Component\DependencyInjection\ParameterBag\ContainerBagInterface;

class MessageGenerator
{
    private $params;

    public function __construct(ContainerBagInterface $params)
    {
        $this->params = $params;
    }

    public function someMethod()
    {
        // получите любой параметр контейнера из $this->params, который хранит их все
        $sender = $this->params->get('mailer_sender');
        // ...
    }
}

Использование PHP ConfigBuilders

Написание PHP-конфигурации иногда бывает сложным, потому что у вас получаются большие вложенные массивы, и у вас нет помощи в автозаполнении из вашего любимого IDE. Это можно решить с помощью "ConfigBuilders". Это объекты, которые помогут вам строить эти массивы.

Symfony генерирует классы ConfigBuilder автоматически в каталоге компоновки ядра для всех пакетов, установленных в вашем приложении. По соглашению, они все живут в пространстве имен Symfony\Config:

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

// config/packages/security.php
use Symfony\Config\SecurityConfig;

return static function (SecurityConfig $security) {
    $security->firewall('main')
        ->pattern('^/*')
        ->lazy(true)
        ->anonymous();

    $security
        ->roleHierarchy('ROLE_ADMIN', ['ROLE_USER'])
        ->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'])
        ->accessControl()
            ->path('^/user')
            ->role('ROLE_USER');

    $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
};

Не останавливайтесь!

Поздравляем ! Вы справились с основами Symfony. Далее, узнайте о каждой части Symfony отдельно, cледуя руководствами. Посмотрите:

• Формы
• Базы данных и Doctrine ORM
• Сервис-контейнер
• Безопасность
• Отправка писем с помощью Mailer
• Логирование

И все другие темы, связанные с конфигурацией: