현대 PHP에서 의존성 주입(DI)은 어떻게 동작하나요?

Question

Accepted Answer

**의존성 주입(Dependency Injection, DI)**은 클래스가 자신의 의존성을 직접 생성하는 대신 외부에서(보통 생성자를 통해) 받는 설계 패턴입니다. 현대 PHP 프레임워크는 DI를 크게 활용하며, 종종 의존성을 자동으로 해석하고 주입하는 **컨테이너**와 함께 사용합니다 — 느슨하게 결합되고 테스트 가능한 코드로 이어집니다.

## DI가 해결하는 문제

```php
// ❌ 강한 결합 — 클래스가 자신의 의존성을 생성 (테스트/교체 어려움)
class UserService {
    private $mailer;
    public function __construct() {
        $this->mailer = new SmtpMailer();   // 하드코딩 → 모킹 불가, 교체 불가
    }
}

// ✅ 의존성 주입 — 의존성이 전달됨
class UserService {
    public function __construct(private MailerInterface $mailer) {}
    // 인터페이스에 의존, 구체적 구현은 외부에서 받음
}
```

의존성을(**인터페이스**에 대해) 주입하면 클래스가 구체적 구현으로부터 분리됩니다 — 구현을 교체하고 테스트에서 모킹을 주입할 수 있습니다.

## 생성자 주입 (표준 형태)

```php
class OrderService {
    public function __construct(
        private OrderRepository $repo,        // 의존성을 생성자에 선언
        private MailerInterface $mailer,
        private LoggerInterface $logger,
    ) {}
}
```

생성자 주입은 의존성을 명시적으로 만들고 객체가 생성될 때 완전히 형성되도록 보장합니다.

## DI 컨테이너 — 자동 해석

```php
// DI 컨테이너가 전체 의존성 그래프를 자동으로 해석하며 객체를 구축
$container->bind(MailerInterface::class, SmtpMailer::class);   // 인터페이스 → 구현 매핑

$service = $container->get(OrderService::class);
// 컨테이너는 OrderService가 OrderRepository, MailerInterface, LoggerInterface를 필요로 함을 보고,
// 각각을 (재귀적으로) 구축하고 주입함 — 수동으로 new 하지 않음
```

**DI 컨테이너**(Laravel, Symfony, 또는 PHP-DI 같은 독립형)는 생성자 의존성을 재귀적으로 해석하여 객체를 자동으로 구축합니다 — 인터페이스-구현 바인딩을 설정하면 컨테이너가 모든 것을 연결합니다.

## 이점

```text
✓ 느슨한 결합 — 구체적 클래스가 아닌 인터페이스/추상화에 의존
✓ 테스트 가능성 — 테스트에서 모킹/페이크 주입 (실제 DB/메일러 불필요)
✓ 유연성 — 컨테이너 설정으로 구현 교체 (예: 개발 환경의 페이크 메일러)
✓ 단일 책임 — 클래스가 의존성 생성이 아닌 로직에 집중
```

## 왜 중요한가

의존성 주입은 현대 PHP의 근본 패턴으로, 전문적인 애플리케이션과 프레임워크(Laravel, Symfony)가 구조화되는 방식의 중심이므로, 이를 이해하는 것은 중요한 시니어 수준 지식입니다.

핵심 가치는 **분리와 테스트 가능성**입니다. 클래스가 의존성을 생성하는 대신(인터페이스에 대해 선언된) 받게 함으로써, 코드는 느슨하게 결합되고(구체적 구현이 아닌 추상화에 의존), 쉽게 **테스트 가능**해지며(실제 데이터베이스/서비스 대신 모킹을 주입 — 철저한 단위 테스트를 실용적으로 만듦), 유연해집니다(설정으로 구현 교체).

현대 PHP 프레임워크는 이를 자동화하는 **DI 컨테이너**를 제공합니다 — 인터페이스-구현 바인딩을 기반으로 전체 의존성 그래프를 자동으로 해석하고 주입하므로, 수동으로 객체를 구축하지 않습니다.

생성자 주입(표준 형태), 인터페이스를 향한 프로그래밍, DI 컨테이너가 동작하는 방식(자동 해석)을 이해하는 것은 PHP 프레임워크(DI를 중심으로 구축됨)와 효과적으로 작업하고 잘 설계되고 유지보수 가능하며 테스트 가능한 코드를 작성하는 데 필수적입니다.

DI가 모든 주요 현대 PHP 프레임워크의 구조를 떠받치고 전문적인 애플리케이션 설계의 특징이므로, 이를 숙달하는 것 — 패턴, 그 이점, 컨테이너 기반 해석 — 은 깔끔하고 테스트 가능하며 프레임워크 관용적인 PHP를 구축할 수 있는 개발자를, 강하게 결합되고 테스트하기 어려운 코드를 작성하는 개발자와 구별 짓는 중요한 지식입니다.