Хроники Yii3

⚡️ #yiisoftDi

Большое обновление сервис-провайдеров в контейнере зависимостей Yii Dependency Injection (PR).

По сути это абсолютно новые сервис-провайдеры. Разрабатывая их, мы ориентировались на container-interop/service-provider (но сделали всё-таки немного по-другому).

Вместо наследования от класса, теперь провайдеры должны реализовывать интерфейс Yiisoft\Di\Contracts\ServiceProviderInterface, содержащий два метода:

• getDefinitions() определяет дефинишены для контейнера. Этот метод:

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

• getExtensions() возвращает функции обратного вызова, модифицирующие сервисы после их создания. В функцию передаются два аргумента: контейнер и созданный сервис, Возвращает функция сам сервис. Пример:

static function (ContainerInterface $container, MyService $service) {
    return $service->withAnotherOption(42);
}

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

Пример сервис-провайдера:

use Yiisoft\Di\Container;
use Yiisoft\Di\Support\ServiceProvider;

final class CarFactoryProvider extends ServiceProviderInterface
{
    public function getDependencies(): array
    {
        return [
            CarFactory::class => [
                'class' => CarFactory::class,
                '$color' => 'red',
            ], 
            EngineInterface::class => SolarEngine::class,
            WheelInterface::class => [
                'class' => Wheel::class,
                '$color' => 'black',
            ],
            CarInterface::class => [
                'class' => BMW::class,
                '$model' => 'X5',
            ],
        ];    
    }
     
    public function getExtensions(): array
    {
        return [
            // Класс Garage должен быть уже определён в контейнере
            Garage::class => function(ContainerInterface $container, Garage $garage) {
                $car = $container->get(CarFactory::class)->create();
                $garage->setCar($car);
                return $garage;
            }
        ];
    } 
}

—————

В рамках этого PR были удалены классы и интерфейсы DeferredServiceProviderInterface, DeferredServiceProvider, ServiceProvider и AbstractContainerConfigurator.

—————

#yiisoftApp #yiisoftAppApi #yiisoftDemo #yiisoftDemoApi

В процессе адаптации пакетов, использующих сервис-провайдеры была реализована концепция начальной загрузки (bootstrap) в приложениях:

- шаблон веб-приложения (PR),
- шаблон API-приложения (PR),
- демо веб-приложения (PR, PR),
- демо API-приложения (PR).

Bootstrap представляет собой массив функций (точнее callable) вида function (ContainerInterface $container): void, которые последовательно будут вызваны при запуске приложения.

—————

#yiisoftWidget #yiisoftYiiCycle #yiisoftYiiFilesystem #yiisoftYiiDebug #yiisoftYiiDebugApi #yiisoftYiiSentry

Пакеты, использующие сервисы, были адаптированы под новую реализацию:

- Yii Widget (PR),
- Yii Cycle (PR),
- Yii Filesystem (PR),
- Yii Debug (PR),
- Yii Debug Api (PR),
- Yii Sentry (PR).

365 viewsСергей Предводителев, 14:30