Как обращаться к методам trait внутри класса?

Question

После подключения trait его методы вызываются как обычные методы класса через $this->method(). Если в классе есть метод с таким же именем, он переопределит метод trait. Чтобы всё равно вызвать метод из trait, можно сделать алиас через as и обращаться к нему по новому имени. Это полезно для расширения поведения, а не полной замены.

YeaHub · Accepted Answer

Когда вы подключили trait, его методы “вклеиваются” в класс, поэтому обычно вы обращаетесь к ним так же, как к любым методам объекта. Но есть важные нюансы, если вы хотите изменить поведение.1) Обычный вызов метода traitЕсли конфликтов нет, trait-метод вызывается напрямую:trait CanLog {
    protected function log(string $msg): void {
        // ... запись в лог
    }
}

class Service {
    use CanLog;

public function run(): void {
        $this->log('started');
    }
}
2) Что происходит, если класс объявит метод с тем же именемОпределение:Если класс содержит метод с таким же именем, как в trait, метод класса имеет приоритет, а метод trait становится “скрыт”.trait CanLog {
    protected function log(string $msg): void {
        // trait-логика
    }
}

class Service {
    use CanLog;

protected function log(string $msg): void {
        // новая логика
    }
}
В этом случае $this->log() вызовет метод класса.3) Как вызвать оригинальный метод trait, если вы его “переопределили”Чтобы сохранить доступ к реализации из trait, обычно делают алиас.3.1) Создание алиаса для метода traittrait CanLog {
    protected function log(string $msg): void {
        // trait-логика
    }
}

class Service {
    use CanLog {
        log as traitLog;
    }

protected function log(string $msg): void {
        $this->traitLog($msg);   // вызов метода trait по алиасу
        // ... дополнительная логика
    }
}
3.2) Зачем это нужноВы хотите расширить поведение, а не заменить целикомНужно обернуть trait-метод доп. проверкамиНужно добавить метрики/тайминг вокруг вызова4) Видимость методов trait внутри классаВажно помнить, что доступ зависит от модификатора:public — доступен отовсюдуprotected — доступен внутри класса и наследниковprivate — доступен только внутри класса, но с traits есть тонкости, поэтому чаще для traits используют protected5) Практический паттерн: “добавить поведение поверх trait”Частый сценарий — оставить trait как базовую реализацию и добавить обвязку:class Service {
    use CanLog {
        log as traitLog;
    }

public function run(): void {
        $this->log('start');
        // ... работа
        $this->log('finish');
    }

protected function log(string $msg): void {
        $this->traitLog('[service] ' . $msg);
    }
}
Краткий выводОбычно методы trait вызываются как обычные методы через $this->method(). Если вы переопределяете метод в классе, но хотите всё равно использовать реализацию из trait, делайте алиас через as и вызывайте trait-метод по новому имени. Это помогает аккуратно расширять поведение без копипасты.