Як впроваджувати значення, засновані на складних виразах

Сервіс-контейнер також підтримує "вираз", який дозволяє вам впроваджувати особливі значення у сервіс.

Наприклад, уявіть, що у вас є сервіс (тут не показаний) під назвою App\Mail\MailerConfiguration, який має в собі метод getMailerMethod(). Він повертає рядок на кшталт sendmail, засновуючись на якійсь конфігурації.

Уявіть, що ви хочете передати результато цього методу в якості аргументу конструктора іншому сервісу: App\Mailer. Один зі способів зробити це - за допомогою виразу:

1
2
3
4
5
6
7
8
9
10
11

# config/services.yaml
services:
    # ...

    App\Mail\MailerConfiguration: ~

    App\Mailer:
        # префікс '@=' обовʼязковий при використанні виразів для аргументів у файлах YAML
        arguments: ['@=service("App\\Mail\\MailerConfiguration").getMailerMethod()']
        # при використанні рядків з подвійними лапками, зворотний слеш повинен бути екранований двічі (див. https://yaml.org/spec/1.2/spec.html#id2787109)
        # аргументи: ["@=service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()"]

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

        <service id="App\Mail\MailerConfiguration"></service>

        <service id="App\Mailer">
            <argument type="expression">service('App\\Mail\\MailerConfiguration').getMailerMethod()</argument>
        </service>
    </services>
</container>

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

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

use App\Mail\MailerConfiguration;
use App\Mailer;

return function(ContainerConfigurator $container): void {
    // ...

    $services->set(MailerConfiguration::class);

    $services->set(Mailer::class)
        // через екранування, застосованого PHP, ви повинні додати 4 зворотних слеші для кожного початкового зворотного слешу
        ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
};

Щоб дізнатися більше про синтаксис мови виразів, див. .

У цьому контексті, у вас є доступ до 2 функцій:

service

Повертає даний сервіс (дивіться приклад вище).

parameter

Повертає конкретне значення параметру (синтаксис такий же, як у service).

env

Повертає значення змінної середовища.

Ви також маєте доступ до Container через змінну container. Ось ще один приклад:

1
2
3
4
5

# config/services.yaml
services:
    App\Mailer:
        # префікс '@=' обовʼязковий при використанні виразів для аргументів у файлах YAML
        arguments: ["@=container.hasParameter('some_param') ? parameter('some_param') : 'default_value'"]

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

    <services>
        <service id="App\Mailer">
            <argument type="expression">container.hasParameter('some_param') ? parameter('some_param') : 'default_value'</argument>
        </service>
    </services>
</container>

1
2
3
4
5
6
7
8
9
10
11

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

use App\Mailer;

return function(ContainerConfigurator $container): void {
    $services = $container->services();

    $services->set(Mailer::class)
        ->args([expr("container.hasParameter('some_param') ? parameter('some_param') : 'default_value'")]);
};

Виази можуть бути використані в arguments, properties, в якості аргументів з configurator і аргументів до calls (виклики методу), та у factories (фабрики сервісів).