现代 PHP 中依赖注入是如何工作的？

Question

现代 PHP 中依赖注入是如何工作的？

Accepted Answer

**依赖注入 (DI)** 是一种设计模式，其中类从外部（通常通过构造函数）接收其依赖，而不是自己创建它们。现代 PHP 框架大量使用 DI，通常带有一个**容器**，它自动解析和注入依赖——导致代码松散耦合、易于测试。

## 为什么这很重要

```php
// ❌ tight coupling — the class CREATES its own dependencies (hard to test/swap)
class UserService {
    private $mailer;
    public function __construct() {
        $this->mailer = new SmtpMailer();   // hardcoded → can't mock, can't swap
    }
}

// ✅ dependency injection — dependencies are PASSED IN
class UserService {
    public function __construct(private MailerInterface $mailer) {}
    // depends on an INTERFACE, receives the concrete impl from outside
}
```

注入依赖（针对**接口**）将类与具体实现解耦——您可以交换实现并在测试中注入模拟对象。

## 构造函数注入（标准形式）

```php
class OrderService {
    public function __construct(
        private OrderRepository $repo,        // dependencies declared in the constructor
        private MailerInterface $mailer,
        private LoggerInterface $logger,
    ) {}
}
```

构造函数注入使依赖显式化，并确保对象在创建时完全形成。

## DI 容器——自动解析

```php
// a DI CONTAINER builds objects, resolving the whole dependency graph automatically
$container->bind(MailerInterface::class, SmtpMailer::class);   // map interface → impl

$service = $container->get(OrderService::class);
// the container sees OrderService needs OrderRepository, MailerInterface, LoggerInterface,
// constructs each (recursively), and injects them — you don't `new` anything manually
```

**DI 容器**（在 Laravel、Symfony 或独立的 PHP-DI 中）通过递归解析构造函数依赖来自动构造对象——您配置接口到实现的绑定，容器自动连接一切。

## 优势

```text
✓ Loose coupling — depend on interfaces/abstractions, not concrete classes
✓ Testability — inject mocks/fakes in tests (no real DB/mailer needed)
✓ Flexibility — swap implementations via container config (e.g. fake mailer in dev)
✓ Single responsibility — classes focus on logic, not constructing dependencies
```

## 为什么这很重要

依赖注入是现代 PHP 中的基础模式，是专业应用程序和框架（Laravel、Symfony）结构化方式的核心，因此理解它对于高级级别的知识至关重要。

核心价值是**解耦和可测试性**：通过让类接收其依赖（针对接口声明）而不是创建它们，代码变得松散耦合（依赖于抽象，而不是具体实现），易于**测试**（您注入模拟对象而不是真实数据库/服务——使彻底的单元测试实际可行），并且灵活（通过配置交换实现）。

现代 PHP 框架提供**DI 容器**来自动化此过程——基于接口到实现的绑定自动解析和注入整个依赖图，因此您无需手动构造对象。

理解构造函数注入（标准形式）、针对接口编程以及 DI 容器如何工作（自动解析）对于有效地使用 PHP 框架（它们围绕 DI 构建）以及编写架构良好、可维护、可测试的代码至关重要。

由于 DI 支撑所有主要现代 PHP 框架的结构，并且是专业应用程序设计的标志，掌握它——模式、其优势和基于容器的解析——是重要的知识，区分了能够构建干净、可测试、符合框架习惯的 PHP 的开发人员和那些编写紧密耦合、难以测试代码的开发人员。