Як впроваджувати екземпляри у контейнер

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

Наприклад, сервіс kernel у Symfony впроваджується у контейнер з класу Kernel:

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

// ...
use Symfony\Component\HttpKernel\KernelInterface;
use Symfony\Component\HttpKernel\TerminableInterface;

abstract class Kernel implements KernelInterface, TerminableInterface
{
    // ...

    protected function initializeContainer(): void
    {
        // ...
        $this->container->set('kernel', $this);

        // ...
    }
}

Сервіси, які встановлюються під час рантайму, називаються синтетичними сервісами. Такий сервіс повиинен бути сконфігурований, щоб під час компіляції контейнер знав, що він існує (інакше, сервіси, що залежать від kernel, отримають помилку "сервіс не існує").

Для того, щоб зробити це, відмітьте сервіс як синтетичний у вашій конфігурації визначення сервісу:

1
2
3
4
5

# config/services.yaml
services:
    # синтетичні сервіси не визначають клас
    app.synthetic_service:
        synthetic: true

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

<!-- 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.synthetic_service" synthetic="true"/>

    </services>
</container>

1
2
3
4
5
6
7
8
9
10

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

return function(ContainerConfigurator $configurator) {
    $services = $configurator->services();

    // синтетичні сервіси не визначають клас
    $services->set('app.synthetic_service')
        ->synthetic();
};

Тепер ви можете впроваджувати екземпляр у контейнер, використовуючи метод Container::set():

1
2
3

// інстанціюйте синтетичний сервіс
$theService = ...;
$container->set('app.synthetic_service', $theService);