Dependency Injection контейнер для PHP

Dependency Injection контейнер для PHP: Полное руководство

Dependency Injection (DI) — это один из ключевых паттернов проектирования в объектно-ориентированном программировании, который позволяет создавать слабосвязанные, тестируемые и легко поддерживаемые приложения. В PHP этот подход реализуется с помощью специальных инструментов — Dependency Injection контейнеров (также известных как контейнеры внедрения зависимостей). В этой статье мы подробно разберем, что такое DI контейнер, как он работает, и рассмотрим лучшие библиотеки для PHP.

Что такое Dependency Injection?

Dependency Injection — это техника, при которой объект получает свои зависимости извне, а не создает их самостоятельно. Вместо того чтобы писать new Database() внутри класса, вы передаете готовый объект через конструктор, сеттер или интерфейс. Это делает код более гибким и упрощает тестирование.

Пример без DI:

class UserService {
    private $db;

    public function __construct() {
        $this->db = new Database(); // жесткая связь
    }
}

Пример с DI через конструктор:

class UserService {
    private $db;

    public function __construct(Database $db) {
        $this->db = $db; // зависимость передается извне
    }
}

Зачем нужен DI контейнер?

Когда в проекте становится много классов и зависимостей, ручное создание объектов и передача зависимостей превращается в головную боль. DI контейнер автоматизирует этот процесс. Он выступает в роли центрального реестра, который знает, как создавать объекты и разрешать их зависимости.

Основные возможности DI контейнера:

Автоматическое разрешение зависимостей — контейнер сам находит и подставляет нужные объекты.
Управление жизненным циклом объектов — можно настроить, создавать ли каждый раз новый экземпляр или использовать один (синглтон).
Конфигурация через код или файлы — зависимости можно описывать в PHP, YAML, XML или аннотациях.
Поддержка интерфейсов и абстракций — контейнер может связывать интерфейс с конкретной реализацией.

Популярные DI контейнеры для PHP

В экосистеме PHP существует несколько зрелых решений. Рассмотрим наиболее популярные:

1. PHP-DI (PHP Dependency Injection)

Один из самых мощных и удобных контейнеров. Поддерживает автозаполнение (autowiring), аннотации, конфигурацию через PHP-массивы и YAML. Отлично подходит для современных приложений.

Пример использования PHP-DI:

use DI\ContainerBuilder;

$builder = new ContainerBuilder();
$builder->addDefinitions([
    'db.host' => 'localhost',
    Database::class => DI\create()
        ->constructor(DI\get('db.host')),
]);

$container = $builder->build();
$db = $container->get(Database::class);

2. Symfony DependencyInjection

Компонент из фреймворка Symfony, который можно использовать отдельно. Предлагает гибкую конфигурацию через YAML, XML или PHP. Идеален для больших enterprise-проектов.

Пример конфигурации в YAML:

services:
    App\Service\UserService:
        arguments:
            - '@App\Repository\UserRepository'
            - '@logger'

3. Laravel Service Container

Встроенный контейнер фреймворка Laravel. Поддерживает автозаполнение, привязку интерфейсов к реализациям, контекстное связывание и множество других функций. Используется по умолчанию в Laravel.

Пример привязки интерфейса:

use App\Contracts\PaymentGateway;
use App\Services\StripePayment;

$this->app->bind(PaymentGateway::class, StripePayment::class);

4. Pimple

Легковесный DI контейнер, созданный создателем Symfony. Подходит для небольших проектов, где не нужна сложная конфигурация. Работает через замыкания (closures).

Пример использования Pimple:

use Pimple\Container;

$container = new Container();
$container['db'] = function ($c) {
    return new Database($c['db.host']);
};

$db = $container['db'];