Что произойдёт в PHP, если использовать два трейта с методами, имеющими одинаковые сигнатуры?

PHP выдаст фатальную ошибку Fatal error: Trait method ... has not been applied, because there are collisions with other trait methods... на этапе компиляции, так как не может неявно решить, какой метод использовать.

Решение конфликта должно быть явным. Для этого внутри класса, использующего трейты, применяются операторы insteadof и as.

Практический пример из реального проекта: У меня был класс DocumentExporter, которому нужна была логика логирования из двух разных библиотек (одна для внутреннего лога, другая для отправки в Sentry), но в обоих трейтах был метод log().

// Трейты с конфликтующими методами
trait LocalLoggerTrait {
    public function log(string $message): void {
        file_put_contents('app.log', $message, FILE_APPEND);
    }
}

trait ExternalLoggerTrait {
    public function log(string $message): void {
        $this->sendToSentry($message); // Упрощённо
    }
}

// Класс, разрешающий конфликт
class DocumentExporter {
    use LocalLoggerTrait, ExternalLoggerTrait {
        // Явно указываем, что метод из ExternalLoggerTrait
        // должен использоваться под именем `log` вместо метода из LocalLoggerTrait
        ExternalLoggerTrait::log insteadof LocalLoggerTrait;
        // Создаём алиас для метода из LocalLoggerTrait,
        // чтобы он всё ещё был доступен
        LocalLoggerTrait::log as localLog;
    }

    public function export(): void {
        $this->log('Export started'); // Вызовет ExternalLoggerTrait::log
        // ... логика экспорта ...
        $this->localLog('Backup log entry'); // Вызовет LocalLoggerTrait::log
    }
}

Ключевые моменты:

• Конфликт не разрешается автоматически, требуется явное указание.
• insteadof выбирает один метод для использования под оригинальным именем.
• as позволяет создать алиас для другого метода, сохранив к нему доступ.
• Это даёт гибкость для интеграции кода из разных источников без необходимости их изменения.