trait이란 무엇이며 언제 사용하나요?

Question

Accepted Answer

**trait**은 상속으로 관련되지 않은 **여러 클래스 간에 코드를 재사용**하기 위한 메커니즘입니다. PHP는 단일 상속만 허용하므로, trait은 메서드(와 프로퍼티)를 수평적으로 공유하는 방법을 제공합니다 — 믹스인(mixin)처럼 "조합적인" 코드 재사용의 한 형태입니다.

## trait이 해결하는 문제

```text
PHP는 단일 상속 — 클래스는 단 하나의 부모만 확장할 수 있음. 하지만 무관한 클래스 간에
같은 메서드를 공유하고 싶을 때가 많음 (예: 로깅, 타임스탬프).
코드를 중복하는 것은 나쁨; trait은 상속 없이 재사용하게 해 줌.
```

## trait 정의하고 사용하기

```php
<?php
trait Timestampable {
    private ?DateTime $createdAt = null;

public function setCreatedAt(): void {
        $this->createdAt = new DateTime();
    }
    public function getCreatedAt(): ?DateTime {
        return $this->createdAt;
    }
}

trait Loggable {
    public function log(string $msg): void {
        echo "[" . static::class . "] $msg";
    }
}

// 클래스는 여러 trait을 use 할 수 있음 — 그 메서드가 클래스의 일부가 됨
class Article {
    use Timestampable, Loggable;     // 두 trait의 메서드를 모두 믹스인
}

$a = new Article();
$a->setCreatedAt();    // Timestampable에서
$a->log("created");     // Loggable에서
```

trait은 메서드/프로퍼티의 묶음입니다. 클래스는 하나 이상의 trait을 `use`하여 그 멤버를 **믹스인**합니다 — 공통 부모로부터 상속하지 않고 기능을 얻습니다.

## trait vs 상속 vs 인터페이스

```text
상속 (extends) → 단일 부모, "is-a", 구현을 상속
interface → 계약 (시그니처만, 코드 없음), 다중 허용
trait → 재사용 가능한 구현 (실제 코드), 다중 허용, 계약 없음
→ 인터페이스는 클래스가 무엇을 할 수 있는지(WHAT)를 말하고; trait은 어떻게(HOW, 공유 코드)를 제공.
  둘은 종종 함께 사용됨: 인터페이스를 구현하고, 구현에는 trait을 use.
```

## 충돌 해결

```php
class X {
    use TraitA, TraitB {
        TraitA::hello insteadof TraitB;   // 둘 다 hello()를 정의하면 TraitA의 것 선택
        TraitB::hello as helloB;           // TraitB의 버전에 별칭 부여
    }
}
```

두 trait이 같은 메서드를 정의하면, PHP는 충돌을 명시적으로 해결하게 합니다.

## 왜 중요한가

trait은 **무관한 클래스 간 코드 재사용**을 위한 중요한 PHP 기능으로, 실제 제약을 해결합니다. PHP가 단일 상속만 허용하므로, trait은 공통 기능 — 로깅, 타임스탬프, 소프트 삭제, 직렬화 헬퍼 — 을 부모를 공유하지 않는 클래스 간에 공유하는 수평적 재사용(믹스인)을 제공합니다.

이를 이해하는 것이 가치 있는 이유는 PHP 프레임워크에서 널리 사용되기 때문입니다(Laravel의 Eloquent는 `SoftDeletes`, `HasFactory` 같은 모델 동작에 trait을 광범위하게 사용), 그래서 끊임없이 접하고 사용하게 될 것입니다.

trait이 상속(is-a 관계 없는 재사용)과 인터페이스(trait은 실제 *구현*/코드를 제공하고, 인터페이스는 *계약*/시그니처만 정의 — 둘은 종종 결합: 인터페이스가 기능을 선언하고 trait이 공유 구현을 제공)와 어떻게 다른지를 아는 것이 이들을 적절히 사용하는 관건입니다.

trait은 단일 상속만으로는 불가능한 DRY하고 조합적인 설계를 가능하게 하므로, 재사용 가능한 PHP 코드를 작성하고 그 주위에 구축된 프레임워크를 이해하는 데 모두 실용적이고 자주 접하는 지식입니다. (주의: trait을 남용하면 동작이 어디서 오는지 모호해질 수 있으므로, 기본값이 아닌 진정한 횡단 관심사 재사용에 사용하세요.)