Трейты (Traits) против Интерфейсов (Interfaces) в PHP: когда что использовать?

Ключевое различие: Контракт (Interface) vs. Реализация (Trait)

Отличный вопрос! Вы почти правильно поняли суть. Давайте разложим по полочкам.

Интерфейс (Interface) — это контракт или обязательство. Он говорит: "У тебя, класс, должен быть этот метод с такой сигнатурой". Интерфейс не содержит кода. Он только описывает, что должен уметь делать класс, но не говорит, как.

Трейт (Trait) — это готовая реализация. Это механизм для повторного использования кода в языках с одинарным наследованием (как PHP). Трейт содержит реальный код методов, который вы можете "вклеить" в любой класс.

Когда использовать Interface?

• Когда вам нужно гарантировать, что разные классы имеют одинаковый набор публичных методов (API).
• Когда вы пишете код, который должен работать с разными объектами, не зная их конкретного типа (полиморфизм).
• Когда реализация метода может быть совершенно разной у разных классов.

Когда использовать Trait?

• Когда у вас есть готовая, повторяющаяся логика, которая нужна в нескольких несвязанных классах.
• Когда вы хотите избежать дублирования кода, но наследование от абстрактного класса не подходит (классы слишком разные).
• Когда трейт предоставляет вспомогательные методы (например, логирование, кэширование, сериализация).

Решаем вашу задачу на примере

Вернёмся к вашему примеру с машиной и велосипедом. Правильная архитектура — комбинировать оба подхода:

<?php
// 1. Интерфейс — это контракт на возможность движения
interface MovableInterface {
    public function move(): string;
}

// 2. Трейт — это готовая реализация для разных типов движения
trait EnginePoweredMovement {
    public function startEngine(): string {
        return "Двигатель заведён с ключа.";
    }

    // Трейт может реализовывать метод интерфейса!
    public function move(): string {
        return $this->startEngine() . " Поехали на бензине.";
    }
}

trait HumanPoweredMovement {
    public function move(): string {
        return "Крутим педали. Поехали мускульной силой.";
    }
}

// 3. Классы
class Car implements MovableInterface {
    use EnginePoweredMovement; // Берём готовую реализацию движения
    // Дополнительные методы машины...
}

class Bicycle implements MovableInterface {
    use HumanPoweredMovement; // Своя реализация движения
    // Дополнительные методы велосипеда...
}

class ElectricScooter implements MovableInterface {
    use EnginePoweredMovement {
        // Переопределяем работу трейта для конкретного класса
        startEngine as private startElectricMotor;
    }

    // Свой старт
    public function startEngine(): string {
        return "Кнопка нажата. Мотор запущен бесшумно.";
    }
}

// 4. Полиморфизм работает благодаря интерфейсу
function testDrive(MovableInterface $vehicle) {
    echo $vehicle->move() . "\n";
}

$car = new Car();
$bike = new Bicycle();
$scooter = new ElectricScooter();

testDrive($car);    // Двигатель заведён с ключа. Поехали на бензине.
testDrive($bike);   // Крутим педали. Поехали мускульной силой.
testDrive($scooter);// Кнопка нажата. Мотор запущен бесшумно. Поехали на бензине.
?>

Золотое правило

Задайте себе два вопроса:

1. "Должен ли этот метод быть у всех классов этой группы?" Если да — это интерфейс. Если нет — возможно, трейт.
2. "Есть ли у меня готовая реализация, которая подходит нескольким классам?" Если да — используйте трейт. Если реализация уникальна для каждого класса — используйте интерфейс.

В современном PHP (8.0+) трейты могут даже реализовывать абстрактные методы из интерфейсов, как показано выше. Это мощный паттерн: интерфейс задаёт контракт, а трейт даёт реализацию по умолчанию.