Імпорт конфігурації з imports

За замовчуванням, конфігурація сервісу живе у app/config/services.yml. Але якщо цей файл стає більшим, ви можете спокійно реорганізувати його у декілька файлів. Уявіть, що ви вирішили перемістити якусь частину конфігурації у новий файл:

1
2
3
4
5
6

# config/services/mailer.yaml
parameters:
    # ... деякі параметри

services:
    # ... деякі параметри

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

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

    <parameters>
        <!-- ... деякі параметри -->
    </parameters>

    <services>
        <!-- ... деякі параметри -->
    </services>
</container>

1
2
3
4

// config/services/mailer.php

// ... деякі параметри
// ... деякі параметри

Щоб імпортувати цей файл, використайте ключ imports з будь-якого іншого файлу та передайте відносний або абсолютний шлях до імпортованого файлу:

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

# config/services.yaml
imports:
    - { resource: services/mailer.yaml }
    # Якщо ви хочете імпортувати цілий каталог:
    - { resource: services/ }
services:
    _defaults:
        autowire: true
        autoconfigure: true

    App\:
        resource: '../src/*'
        exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'

    # ...

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

    <imports>
        <import resource="services/mailer.xml"/>
        <!-- Якщо ви хочете імпортувати цілий каталог: -->
        <import resource="services/"/>
    </imports>

    <services>
        <defaults autowire="true" autoconfigure="true"/>

        <prototype namespace="App\" resource="../src/*"
            exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>

        <!-- ... -->
    </services>
</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 function(ContainerConfigurator $configurator) {
    $configurator->import('services/mailer.php');
    // Якщо ви хочете імпортувати цілий каталог:
    $configurator->import('services/');

    $services = $configurator->services()
        ->defaults()
            ->autowire()
            ->autoconfigure()
    ;

    $services->load('App\\', '../src/*')
        ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
};

При завантаженні файлу конфігурації, Symfony спочатку завантажує імпортовані файли, а потім обробляє параметри та сервіси, визначені у файлі. Якщо ви використовуєте конфігурацію services.yaml за замовчуванням , як у прикладі вище, визначення App\ створює сервіси для класів, знайдених у ../src/*. Якщо ваш імпортований файл також визначає сервіси для цих класів, вони будуть перевизначені.

Можливим вирішенням цього є додавання класів та/або каталогів імпортованих файлів в опцію exclude визначення App\. Інше рішення - не використовувати імпорт та додати визначення сервісу у тому ж файлі, але після визначення App\, щоб перевизначити його.

Дата обновления перевода 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, зазвичай завантажується з використанням іншого методу: розширення контейнера.

Внутрішньо, кожний пакет визначає свої сервіси у файлах, як ви вже бачили. Однак, ці файли не імпортуються, використовуючи директиву import. Замість цього, пакети використовують розширення впровадження залежності, щоб завантажувати файли автоматично. Як тільки ви включаєте пакет, викликається його розширення, яке може завантажити файли конфігурації сервісу.

Насправді, кожний файл конфігурації у config/packages/ передається розширенню спорідненого з ним пакету - наприклад, FrameworkBundle або TwigBundle - і використовується для подальшої конфігурації цих сервісів.