• 목록

✅ PHP에서 도메인 주도 설계(DDD) 기초 적용하기

**도메인 주도 설계(Domain-Driven Design, DDD)**는 복잡한 비즈니스 로직을 다루는 프로젝트에서 매우 강력한 설계 방식입니다. PHP에서도 프레임워크에 의존하지 않고 DDD의 핵심 개념을 적용할 수 있습니다. 이 글에서는 실무에서 바로 적용할 수 있는 DDD 핵심 구조와 구현 예시를 소개합니다.

📦 DDD 핵심 구성요소

🧱 1. Entity 예시: User

[code=php]
namespace Domain;

class User {
    public function __construct(
        public readonly string $id,
        public string $email,
        public string $name
    ) {}

    public function changeName(string $newName): void {
        $this->name = $newName;
    }
}
[/code]

• id가 고유 식별자 → 동일성 비교 기준

🧩 2. Value Object 예시: Email

[code=php]
namespace Domain;

class Email {
    public function __construct(private string $value) {
        if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
            throw new \InvalidArgumentException("잘못된 이메일 형식");
        }
    }

    public function value(): string {
        return $this->value;
    }

    public function equals(Email $other): bool {
        return $this->value === $other->value;
    }
}
[/code]

• 불변, 동등성 비교 가능, equals() 메서드 주의

📤 3. Repository 인터페이스

[code=php]
namespace Domain;

interface UserRepository {
    public function findById(string $id): ?User;
    public function save(User $user): void;
}
[/code]

• 도메인에서는 저장 방식 모름 → 구현은 인프라 계층에서 처리

⚙️ 4. 도메인 서비스 예시

[code=php]
namespace Domain;

class UserRegistrationService {
    public function __construct(private UserRepository $repo) {}

    public function register(string $id, Email $email, string $name): void {
        if ($this->repo->findById($id)) {
            throw new \Exception("이미 존재하는 사용자");
        }

        $user = new User($id, $email->value(), $name);
        $this->repo->save($user);
    }
}
[/code]

• 도메인 로직이지만 Entity에 넣기 애매한 경우 Service로 분리

📌 DDD의 계층적 구조 (간단 도식)

Presentation (Controller)
    ↓
Application (UseCase / Service)
    ↓
Domain (Entity, ValueObject, RepositoryInterface)
    ↓
Infrastructure (DB, Email, File 등 구현체)

🧠 적용 시 팁

✅ 요약

• DDD는 복잡한 도메인 모델링을 위한 설계 패턴

• PHP에서도 Entity, VO, Repository, Service 구조로 적용 가능

• 프레임워크에 종속되지 않고 비즈니스 로직 중심으로 개발 가능

• 코드보다 중요한 건 도메인 언어에 대한 깊은 이해