Quick start

Быстрый старт

Требования

• PHP ^8.3
• psr/container ^2.0 (подтягивается автоматически)

Установка

composer require cloudcastle/di

Минимальный пример (явная регистрация)

<?php

declare(strict_types=1);

use CloudCastle\DI\Container;

$container = new Container();

$container->set('config.timezone', 'Europe/Moscow');
$container->set('logger', new Psr\Log\NullLogger());

$timezone = $container->get('config.timezone');
$logger = $container->get('logger');

Autowiring

use CloudCastle\DI\Container;

$container = new Container();
$container->enableAutowiring();

// id = полное имя класса
$userService = $container->get(App\Service\UserService::class);

Класс UserService создаётся автоматически; зависимости разрешаются по типам, attributes и (опционально) по имени. Подробнее — Autowiring.

Property и method injection

use CloudCastle\DI\Attribute\Inject;

$container->set('app.metrics', $metrics);
$container->enableAutowiring();
$container->enablePropertyAutowiring(); // typed properties
$container->enableMethodAutowiring();   // setter без attribute

// #[Inject] на свойстве или inject-методе — без enableProperty/MethodAutowiring
$service = $container->get(App\Service\ReportService::class);

Attributes и autowiring по имени

use CloudCastle\DI\Attribute\Inject;

$container->set('app.clock', $clock);
$container->set('logger', $logger);
$container->enableAutowiring();
$container->enableParameterNameAutowiring();

// #[Inject('app.clock')] или параметр $logger → get('logger')
$service = $container->get(App\Service\ReportService::class);

Сканирование каталога

$container->scan(__DIR__ . '/Services', 'App\\Services\\');

Регистрирует все instantiable-классы в каталоге с namespace App\Services\. Существующие set() не перезаписываются. Подробнее — Сканирование классов.

Глобальный реестр

use CloudCastle\DI\Container;
use CloudCastle\DI\ContainerRegistry;

$container = new Container();
$container->enableAutowiring();
ContainerRegistry::set($container);

$service = ContainerRegistry::get()->get(App\Service\UserService::class);

Подробнее — Глобальный реестр.

Идентификаторы сервисов

Идентификаторы — произвольные строки:

Стиль	Пример	Когда
Произвольный ключ	'logger', 'config.db'	явный set()
FQCN	App\Service\Mailer::class	autowiring, scan()

PSR-11

CloudCastle\DI\Container реализует:

• Psr\Container\ContainerInterface — get(), has();
• CloudCastle\DI\Contract\ContainerInterface — set(), hasDefinition(), autowiring, tags, decorators.

if ($container->has('logger')) {
    $logger = $container->get('logger');
}

hasDefinition() — регистрация без создания экземпляра:

if ($container->hasDefinition('repository')) {
    // set() или autowire() есть, get() ещё не вызывался
}

Composition root

Собирайте граф зависимостей в одной точке входа (bootstrap):

function createContainer(): Container
{
    $container = new Container();
    $container->enableAutowiring();
    $container->scan(__DIR__ . '/../src/Application', 'App\\Application\\');

    $container->set(Psr\Log\LoggerInterface::class, new MonologLogger(...));

    return $container;
}

В домен передавайте готовые объекты через конструктор — см. Анти-паттерны.

Дальше

• Autowiring
• Сканирование классов
• Теги и декораторы
• Фабрики и singleton
• Справочник API