PHP 트레이트: use, 여러 트레이트, insteadof

PHP 트레이트는 재사용 가능한 메서드와 속성 묶음입니다. trait Name { ... }으로 선언하고 클래스 본문 안에서 use Name;으로 어느 클래스에든 가져옵니다. PHP가 트레이트의 멤버를 클래스에 복사하므로 그곳에 직접 쓴 것과 정확히 같이 동작합니다.

<?php
trait Greets
{
    public function hello(): string
    {
        return 'Hello from ' . static::class;
    }
}

class User
{
    use Greets;
}

class Robot
{
    use Greets;
}

echo (new User())->hello(), "\n";
echo (new Robot())->hello(), "\n";

User와 Robot에는 공통 부모가 없지만 이제 둘 다 hello()를 가집니다. 트레이트는 이런 경우를 위해 존재합니다. PHP 클래스는 클래스를 하나만 상속할 수 있고, 트레이트는 관련 없는 클래스 사이에서 옆으로 코드를 공유합니다.

속성이 있는 트레이트

트레이트는 메서드와 함께 속성도 가져올 수 있습니다. 트레이트가 복사되면 그 메서드는 클래스의 메서드이므로 다른 메서드처럼 $this를 씁니다.

<?php
trait HasTimestamps
{
    protected ?string $createdAt = null;
    protected ?string $updatedAt = null;

    public function touch(string $now): void
    {
        $this->createdAt ??= $now;
        $this->updatedAt = $now;
    }

    public function timestamps(): string
    {
        return "created {$this->createdAt}, updated {$this->updatedAt}";
    }
}

class Post
{
    use HasTimestamps;

    public function __construct(public string $title) {}
}

$post = new Post('Traits in PHP');
$post->touch('2026-03-14 09:30');
$post->touch('2026-03-15 18:05');
echo $post->title, ': ', $post->timestamps(), "\n";

클래스는 트레이트 속성과 같은 이름의 속성을 선언할 수 없습니다. 두 선언이 동일하면(같은 접근 제어, 타입, 기본값) 예외이며, 그렇지 않으면 치명적 에러입니다.

여러 트레이트 쓰기

use 문 하나에 쉼표로 구분해 여러 트레이트를 나열하거나 use 줄을 여러 개 쓰세요. 클래스는 모든 트레이트의 멤버를 받습니다.

<?php
trait Loggable
{
    private array $log = [];

    public function log(string $msg): void
    {
        $this->log[] = $msg;
    }

    public function history(): array
    {
        return $this->log;
    }
}

trait Sluggable
{
    public function slug(string $text): string
    {
        return trim(preg_replace('/[^a-z0-9]+/', '-', strtolower($text)), '-');
    }
}

class Article
{
    use Loggable, Sluggable;

    public function __construct(public string $title)
    {
        $this->log("created '$title'");
    }

    public function url(): string
    {
        $url = '/blog/' . $this->slug($this->title);
        $this->log("url built: $url");
        return $url;
    }
}

$a = new Article('PHP Traits, Explained!');
echo $a->url(), "\n";
print_r($a->history());

insteadof와 as로 충돌 해결하기

두 트레이트가 같은 이름의 메서드를 정의하면 PHP는 추측하지 않고 치명적 에러와 함께 멈춥니다. use 블록 안에서 insteadof는 이길 쪽을 고르고, as는 진 메서드를 다른 이름으로 남깁니다.

<?php
trait EnglishGreeting
{
    public function greet(): string { return 'Hello'; }
}

trait FrenchGreeting
{
    public function greet(): string { return 'Bonjour'; }
}

class Host
{
    use EnglishGreeting, FrenchGreeting {
        EnglishGreeting::greet insteadof FrenchGreeting;
        FrenchGreeting::greet as greetFrench;
    }
}

$h = new Host();
echo $h->greet(), "\n";
echo $h->greetFrench(), "\n";

블록 없이 그냥 use EnglishGreeting, FrenchGreeting;을 쓰면 스크립트는 아무것도 출력하기 전에 멈춥니다.

PHP Fatal error:  Trait method FrenchGreeting::greet has not been applied as Host::greet, because of collision with EnglishGreeting::greet in /home/index.php on line 12

as는 접근 제어도 바꿀 수 있습니다. use Loggable { log as protected; }는 이 클래스에서만 트레이트의 log()를 protected로 만들고, use Loggable { log as private writeLog; }는 private 별칭을 추가합니다.

트레이트의 추상 멤버와 정적 멤버

트레이트는 추상 메서드를 선언해 자신을 쓰는 클래스에 무언가를 요구할 수 있습니다. 정적 메서드와 정적 속성도 가질 수 있습니다. 트레이트를 쓰는 각 클래스는 정적 속성의 자기 복사본을 받습니다.

<?php
trait CountsInstances
{
    private static int $instances = 0;

    public static function created(): int
    {
        return self::$instances;
    }

    // The using class must say what it is called
    abstract public function label(): string;

    public function register(): string
    {
        self::$instances++;
        return $this->label() . ' #' . self::$instances;
    }
}

class Car
{
    use CountsInstances;

    public function label(): string { return 'Car'; }
}

class Bike
{
    use CountsInstances;

    public function label(): string { return 'Bike'; }
}

echo (new Car())->register(), "\n";
echo (new Car())->register(), "\n";
echo (new Bike())->register(), "\n";
echo 'Cars: ', Car::created(), ', Bikes: ', Bike::created(), "\n";

정적 속성이 각 클래스에 복사되므로 Car와 Bike는 따로 셉니다. 모든 자식이 공유하는, 공통 부모 클래스에 선언한 정적 속성과는 다릅니다. 그 경우는 static 페이지에서 보여 줍니다.

어느 메서드가 이기나: 클래스, 트레이트, 부모

같은 메서드 이름이 클래스 자신, 클래스가 쓰는 트레이트, 부모 클래스에 모두 있으면 PHP는 클래스 자신의 메서드, 트레이트의 것, 부모의 것 순서로 고릅니다. 트레이트 안에서 parent::는 여전히 부모의 버전에 닿습니다.

<?php
class Base
{
    public function hello(): string { return 'Base'; }
    public function bye(): string { return 'Base bye'; }
}

trait Friendly
{
    public function hello(): string { return 'Trait, then ' . parent::hello(); }
    public function bye(): string { return 'Trait bye'; }
}

class Child extends Base
{
    use Friendly;

    public function bye(): string { return 'Child bye'; }
}

$c = new Child();
echo $c->hello(), "\n";  // trait overrides parent
echo $c->bye(), "\n";    // class overrides trait

트레이트는 타입이 아니다

instanceof는 트레이트와 절대 일치하지 않으며, 트레이트 이름으로 타입을 지정한 매개변수는 모든 객체를 TypeError로 거부합니다. "이 클래스에 그 동작이 있는가"를 묻고 싶다면 트레이트를 인터페이스와 짝짓거나 class_uses()로 클래스를 살펴보세요.

<?php
interface Exportable
{
    public function export(): array;
}

trait ExportsProperties
{
    public function export(): array
    {
        return get_object_vars($this);
    }
}

class Invoice implements Exportable
{
    use ExportsProperties;

    public function __construct(public int $id = 7, public float $total = 99.5) {}
}

$inv = new Invoice();
print_r($inv->export());

var_dump($inv instanceof Exportable);
print_r(class_uses($inv));

위의 패턴이 일반적입니다. 인터페이스 Exportable은 함수가 타입 힌트로 쓰고 instanceof가 확인하는 것이고, 트레이트 ExportsProperties는 클래스가 쓰거나 대체할 수 있는 기성 구현입니다. 트레이트만으로는 계약 없는 공유 코드입니다. 비즈니스 로직에서 class_uses()를 확인하고 있다면 그 트레이트 옆에 인터페이스가 필요했던 것입니다. 관련된 클래스 가족이 공유하는 코드라면 추상 클래스가 더 간단한 선택일 수 있습니다.