PHP 依赖注入容器 | 完全指南

PHP 依赖注入容器：它是什么以及为什么需要它？

依赖注入 (DI) 容器是用于管理 PHP 应用程序中依赖关系的强大工具。它自动化了对象创建及其依赖注入的过程，使代码更加模块化、可测试和可维护。在本文中，我们将详细分析 DI 的概念，介绍流行的库，并展示使用示例。

基本概念

依赖 (Dependency) — 类工作所需的任何外部对象（例如，数据库连接、日志记录器、邮件服务）。
依赖注入 (Dependency Injection) — 一种模式，其中依赖关系从外部传递给对象，而不是在对象内部创建。
容器 — 一个集中式存储库，知道如何创建所有依赖关系并管理它们的生命周期。

为什么要使用 DI 容器？

没有 DI 容器，开发人员通常直接在类构造函数中创建依赖关系，这会导致代码高度耦合。这使得测试、组件替换和代码复用变得困难。DI 容器解决了这些问题：

自动依赖解析 (autowiring)。
所有服务的集中配置。
对象生命周期管理（单例、工厂、原型）。
简化单元测试。

流行的 PHP DI 容器

1. PHP-DI (php-di.org)

最流行且功能强大的容器之一。支持自动装配、注解、PHP 配置以及与流行框架的集成。

// PHP-DI 使用示例use DI\\ContainerBuilder;

class Mailer {    public function send($to, $message) {        echo "邮件已发送至 {$to}: {$message}";    }}

class UserService {    private $mailer;        public function __construct(Mailer $mailer) {        $this->mailer = $mailer;    }        public function registerUser($email) {        // 注册逻辑        $this->mailer->send($email, '欢迎！');    }}

$builder = new ContainerBuilder();$container = $builder->build();

$userService = $container->get(UserService::class);$userService->registerUser('user@example.com');

2. Symfony DependencyInjection (symfony.com/doc/current/components/dependency_injection.html)

Symfony 组件，用于同名的框架。具有高性能和可扩展性。配置可以使用 YAML、XML 或 PHP。

// services.yml 配置示例services:    App\\Service\\Mailer:        class: App\\Service\\Mailer            App\\Service\\UserService:        class: App\\Service\\UserService        arguments:            - '@App\\Service\\Mailer'

3. Laravel Service Container (laravel.com/docs/container)

Laravel 内置容器，默认使用。支持自动解析、接口到实现的绑定以及上下文绑定。

// Laravel 中的示例use App\\Services\\PaymentGateway;use App\\Contracts\\PaymentInterface;

// 将接口绑定到实现$this->app->bind(PaymentInterface::class, PaymentGateway::class);

// 自动解析class OrderController {    public function __construct(        private PaymentInterface $payment    ) {}        public function process() {        $this->payment->charge(100);    }}