В чём заключается паттерн «Адаптер» и каковы основные сценарии его применения?

Question

Адаптер — это паттерн, который позволяет двум несовместимым интерфейсам работать вместе. Он "оборачивает" существующий класс и преобразует вызовы в формат, который ожидает клиентский код. Это удобно при интеграции сторонних библиотек, смене API или миграции между системами. Паттерн помогает не переписывать старый код и постепенно переходить на новые реализации.

YeaHub · Accepted Answer

Паттерн «Адаптер»Определение: Адаптер — это объект-обёртка, который приводит интерфейс одного класса к интерфейсу, ожидаемому клиентским кодом.1. Зачем нужен адаптерКогда у вас есть:код, который ожидает определённый интерфейссторонний класс или сервис с другим интерфейсомнеобходимость "подружить" их без переписывания логикиАдаптер выступает как "переводчик".2. Пример проблемыЕсть система, ожидающая интерфейс:phpinterface Logger {
    public function log(string $message): void;
}
Но вы хотите использовать сторонний логгер:phpclass ExternalLogger {
    public function write(string $text) { /* ... */ }
}
Их интерфейсы несовместимы.3. Как работает адаптерСоздаём класс-обёртку, приводящий интерфейс к нужному:phpclass ExternalLoggerAdapter implements Logger {
    public function __construct(private ExternalLogger $logger) {}

public function log(string $message): void {
        $this->logger->write($message);
    }
}
Теперь клиентский код может работать с Logger, а адаптер переводит вызовы в формат ExternalLogger.4. Сценарии примененияИнтеграция сторонних библиотекКогда потребности вашего кода не совпадают с API библиотеки.Плавная миграция между версиями APIНапример, при переходе от старой системы логирования к новой.Унификация интерфейсовНапример, когда разные поставщики данных предоставляют разные форматы.Совместимость с устаревшим кодомАдаптер позволяет работать с новым кодом, сохраняя старую архитектуру.ТестированиеМожно адаптировать классы под интерфейсы, которые удобнее мокать в тестах.5. ВыводАдаптер идеально подходит для задач интеграции и нивелирования различий в интерфейсах. Он облегчает миграции и позволяет добавлять новые варианты поведения без переписывания существующего кода.