Фасад

<?php

/**
* Класс Фасада предоставляет простой интерфейс для сложной логики одной или
* нескольких подсистем. Фасад делегирует запросы клиентов соответствующим
* объектам внутри подсистемы. Фасад также отвечает за управление их жизненным
* циклом. Все это защищает клиента от нежелательной сложности подсистемы.
*/

class Facade
{
    protected $subsystem1;

    protected $subsystem2;

    /**
    * В зависимости от потребностей вашего приложения вы можете предоставить
    * Фасаду существующие объекты подсистемы или заставить Фасад создать их
    * самостоятельно.
    */
    public function __construct(
        Subsystem1 $subsystem1 = null,
        Subsystem2 $subsystem2 = null
    ) {
        $this->subsystem1 = $subsystem1 ?: new Subsystem1();
        $this->subsystem2 = $subsystem2 ?: new Subsystem2();
    }

    /**
    * Методы Фасада удобны для быстрого доступа к сложной функциональности
    * подсистем. Однако клиенты получают только часть возможностей подсистемы.
    */
    public function operation(): string
    {
        $result = "Facade initializes subsystems:\n";
        $result .= $this->subsystem1->operation1();
        $result .= $this->subsystem2->operation1();
        $result .= "Facade orders subsystems to perform the action:\n";
        $result .= $this->subsystem1->operationN();
        $result .= $this->subsystem2->operationZ();

        return $result;
    }
}

/**
* Подсистема может принимать запросы либо от фасада, либо от клиента напрямую.
* В любом случае, для Подсистемы Фасад – это еще один клиент, и он не является
* частью Подсистемы.
*/

class Subsystem1
{
    public function operation1(): string
    {
        return "Subsystem1: Ready!\n";
    }

    // ...

    public function operationN(): string
    {
        return "Subsystem1: Go!\n";
    }
}

/**
* Некоторые фасады могут работать с разными подсистемами одновременно.
*/

class Subsystem2
{
    public function operation1(): string
    {
        return "Subsystem2: Get ready!\n";
    }

    // ...

    public function operationZ(): string
    {
        return "Subsystem2: Fire!\n";
    }
}

/**
* Клиентский код работает со сложными подсистемами через простой интерфейс,
* предоставляемый Фасадом. Когда фасад управляет жизненным циклом подсистемы,
* клиент может даже не знать о существовании подсистемы. Такой подход позволяет
* держать сложность под контролем.
*/

function clientCode(Facade $facade)
{
    // ...
    echo $facade->operation();
    // ...
}

/**
* В клиентском коде могут быть уже созданы некоторые объекты подсистемы. В этом
* случае может оказаться целесообразным инициализировать Фасад с этими
* объектами вместо того, чтобы позволить Фасаду создавать новые экземпляры.
*/

$subsystem1 = new Subsystem1();
$subsystem2 = new Subsystem2();
$facade = new Facade($subsystem1, $subsystem2);
clientCode($facade);

<?php
/**
* Фасад предоставляет единый метод загрузки видео с YouTube. Этот метод
* скрывает всю сложность сетевого уровня PHP, API YouTube и библиотеки
* преобразования видео (FFmpeg).
*/

class YouTubeDownloader
{
    protected $youtube;
    protected $ffmpeg;

    /**
    * Бывает удобным сделать Фасад ответственным за управление жизненным циклом
    * используемой подсистемы.
    */
    public function __construct(string $youtubeApiKey)
    {
        $this->youtube = new YouTube($youtubeApiKey);
        $this->ffmpeg = new FFMpeg();
    }

    /**
    * Фасад предоставляет простой метод загрузки видео и кодирования его в
    * целевой формат (для простоты понимания примера реальный код
    * закомментирован).
    */
    public function downloadVideo(string $url): void
    {
        echo "Fetching video metadata from youtube...\n";
        // $title = $this->youtube->fetchVideo($url)->getTitle();
        echo "Saving video file to a temporary file...\n";
        // $this->youtube->saveAs($url, "video.mpg");

        echo "Processing source video...\n";
        // $video = $this->ffmpeg->open('video.mpg');
        echo "Normalizing and resizing the video to smaller dimensions...\n";
        // $video
        //     ->filters()
        //     ->resize(new FFMpeg\Coordinate\Dimension(320, 240))
        //     ->synchronize();
        echo "Capturing preview image...\n";
        // $video
        //     ->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(10))
        //     ->save($title . 'frame.jpg');
        echo "Saving video in target formats...\n";
        // $video
        //     ->save(new FFMpeg\Format\Video\X264(), $title . '.mp4')
        //     ->save(new FFMpeg\Format\Video\WMV(), $title . '.wmv')
        //     ->save(new FFMpeg\Format\Video\WebM(), $title . '.webm');
        echo "Done!\n";
    }
}

/**
* Подсистема API YouTube.
*/

class YouTube
{
    public function fetchVideo(): string { /* ... */ }

    public function saveAs(string $path): void { /* ... */ }

    // ...дополнительные методы и классы...
}

/**
* Подсистема FFmpeg (сложная библиотека работы с видео/аудио).
*/

class FFMpeg
{
    public static function create(): FFMpeg { /* ... */ }

    public function open(string $video): void { /* ... */ }

    // ...more methods and classes... RU: ...дополнительные методы и классы...
}

class FFMpegVideo
{
    public function filters(): self { /* ... */ }

    public function resize(): self { /* ... */ }

    public function synchronize(): self { /* ... */ }

    public function frame(): self { /* ... */ }

    public function save(string $path): self { /* ... */ }

    // ...more methods and classes... RU: ...дополнительные методы и классы...
}


/**
* Клиентский код не зависит от классов подсистем. Любые изменения внутри кода
* подсистем не будут влиять на клиентский код. Вам нужно будет всего лишь
* обновить Фасад.
*/

function clientCode(YouTubeDownloader $facade)
{
    // ...

    $facade->downloadVideo("https://www.youtube.com/watch?v=QH2-TGUlwu4");

    // ...
}

$facade = new YouTubeDownloader("APIKEY-XXXXXXXXX");
clientCode($facade);

<?php
// Подсистемы (изменять нельзя)
class InventoryService {
    public function checkAvailability(int $itemId, int $qty): bool {
        echo "[Inventory] Проверка наличия товара #{$itemId}, кол-во: {$qty}\n";
        return true;
    }

    public function reserve(int $itemId, int $qty): string {
        $reservationId = "RES-{$itemId}-{$qty}";
        echo "[Inventory] Зарезервировано: {$reservationId}\n";
        return $reservationId;
    }

    public function release(string $reservationId): void {
        echo "[Inventory] Резервация {$reservationId} снята\n";
    }
}

class PaymentService {
    public function authorize(int $userId, float $amount, string $method): string {
        echo "[Payment] Авторизация {$amount} руб. для #{$userId} через {$method}\n";
        return "AUTH-{$userId}-" . (int)$amount;
    }

    public function capture(string $authId): string {
        echo "[Payment] Списание по авторизации {$authId}\n";
        return "TXN-{$authId}";
    }

    public function refund(string $transactionId): void {
        echo "[Payment] Возврат по транзакции {$transactionId}\n";
    }
}

class ShippingService {
    public function calculateCost(array $items): float {
        $cost = count($items) * 150.0;
        echo "[Shipping] Стоимость доставки: {$cost} руб.\n";
        return $cost;
    }

    public function createShipment(int $userId, array $items): string {
        $shipmentId = "SHIP-{$userId}";
        echo "[Shipping] Создана отправка: {$shipmentId}\n";
        return $shipmentId;
    }
}

class NotificationService {
    public function sendConfirmation(int $userId, string $orderId): void {
        echo "[Notify] Подтверждение заказа {$orderId} отправлено пользователю #{$userId}\n";
    }

    public function sendFailure(int $userId, string $reason): void {
        echo "[Notify] Уведомление об ошибке для #{$userId}: {$reason}\n";
    }
}

// TODO: реализовать фасад OrderFacade:
// - __construct() — создаёт экземпляры всех подсистем
// - placeOrder(int $userId, array $items, string $paymentMethod): ?string
//   Шаги:
//   1. Проверить наличие и зарезервировать каждый товар
//   2. Рассчитать доставку и итоговую сумму
//   3. Авторизовать и списать оплату
//   4. Создать отправку
//   5. Уведомить пользователя
//   При ошибке на любом шаге — откатить резервации и уведомить об ошибке

// Клиентский код
// $facade = new OrderFacade();
// $orderId = $facade->placeOrder(
//     userId: 42,
//     items: [['id' => 1, 'qty' => 2, 'price' => 500], ['id' => 3, 'qty' => 1, 'price' => 1200]],
//     paymentMethod: 'card'
// );
// echo "\nЗаказ создан: {$orderId}\n";

<?php
// Подсистемы (изменять нельзя)
class User {
    public function __construct(
        public int    $id,
        public string $name,
        public string $email,
        public string $passwordHash,
    ) {}
}

class UserRepository {
    private array $users = [];
    private int $nextId = 1;

    public function findByEmail(string $email): ?User { return $this->users[$email] ?? null; }

    public function save(User $user): User {
        $this->users[$user->email] = $user;
        echo "[UserRepo] Пользователь сохранён: {$user->email}\n";
        return $user;
    }

    public function nextId(): int { return $this->nextId++; }
}

class PasswordHasher {
    public function hash(string $plain): string { return hash('sha256', $plain); }
    public function verify(string $plain, string $hashed): bool { return $this->hash($plain) === $hashed; }
}

class TokenService {
    public function generate(int $userId): string {
        $token = bin2hex(random_bytes(16));
        echo "[Token] Выдан токен для #{$userId}: " . substr($token, 0, 8) . "...\n";
        return $token;
    }

    public function invalidate(string $token): void {
        echo "[Token] Токен " . substr($token, 0, 8) . "... инвалидирован\n";
    }
}

class SessionStore {
    private array $sessions = [];

    public function create(string $token, int $userId): void {
        $this->sessions[$token] = $userId;
        echo "[Session] Сессия создана для пользователя #{$userId}\n";
    }

    public function destroy(string $token): void {
        unset($this->sessions[$token]);
        echo "[Session] Сессия удалена\n";
    }

    public function getUserId(string $token): ?int { return $this->sessions[$token] ?? null; }
}

// TODO: реализовать фасад AuthFacade:
// - __construct() — создаёт экземпляры всех подсистем
// - register(name, email, password): string
//   1. Проверить, что email не занят
//   2. Хэшировать пароль, сохранить пользователя
//   3. Выдать токен и создать сессию
//   Бросать InvalidArgumentException если email уже занят
// - login(email, password): string
//   1. Найти пользователя, проверить пароль
//   2. Выдать токен и создать сессию
//   Бросать InvalidArgumentException при неверных данных
// - logout(token): void — инвалидировать токен и удалить сессию

// Клиентский код
// $auth = new AuthFacade();
// $token = $auth->register('Анна', '[email protected]', 'secret123');
// echo "Зарегистрирована, токен: " . substr($token, 0, 8) . "...\n";
// $auth->logout($token);
// $token2 = $auth->login('[email protected]', 'secret123');
// echo "Вошла, токен: " . substr($token2, 0, 8) . "...\n";

<?php
// Подсистемы (изменять нельзя)
class DataQueryService {
    public function query(string $reportType, array $filters): array {
        echo "[Query] Получение данных: type={$reportType}\n";
        return [
            ['label' => 'Январь', 'value' => 150000],
            ['label' => 'Февраль', 'value' => 210000],
            ['label' => 'Март',   'value' => 185000],
        ];
    }
}

class ReportBuilder {
    public function build(array $data, string $reportType): array {
        $total = array_sum(array_column($data, 'value'));
        echo "[Builder] Построение отчёта: " . count($data) . " записей, итого {$total}\n";
        return ['type' => $reportType, 'data' => $data, 'total' => $total];
    }
}

class ChartGenerator {
    public function generate(array $report, string $chartType = 'bar'): string {
        echo "[Chart] Генерация {$chartType}-диаграммы для {$report['type']}\n";
        return "<chart type='{$chartType}' total='{$report['total']}'/>";
    }
}

class ExportService {
    public function export(array $report, string $chart, string $fmt): string {
        $filename = "report_{$report['type']}.{$fmt}";
        echo "[Export] Экспорт в " . strtoupper($fmt) . ": {$filename}\n";
        return $filename;
    }
}

// TODO: реализовать фасад ReportFacade:
// - __construct() — создаёт экземпляры всех подсистем
// - generate(string $reportType, array $filters, string $outputFormat = 'pdf'): string
//   Шаги:
//   1. Запросить данные через DataQueryService
//   2. Построить отчёт через ReportBuilder
//   3. Сгенерировать диаграмму через ChartGenerator
//   4. Экспортировать через ExportService
//   Вернуть имя итогового файла

// Клиентский код — не знает о подсистемах
// $facade = new ReportFacade();
// $file = $facade->generate(
//     reportType: 'sales',
//     filters: ['year' => 2025, 'region' => 'Москва'],
//     outputFormat: 'pdf'
// );
// echo "\nГотово: {$file}\n";

<?php
// Подсистемы (изменять нельзя)
class FileReader {
    public function read(string $path): string {
        echo "[Reader] Читаю файл: {$path}\n";
        return 'raw_media_data';
    }
}

class CodecDetector {
    public function detect(string $data, string $filename): string {
        $ext = strtolower(pathinfo($filename, PATHINFO_EXTENSION));
        $map = ['mp4' => 'h264', 'avi' => 'divx', 'mkv' => 'h265',
                'mp3' => 'mp3',  'wav' => 'pcm',  'flac' => 'flac'];
        $codec = $map[$ext] ?? 'unknown';
        echo "[Codec] Обнаружен кодек: {$codec}\n";
        return $codec;
    }
}

class VideoEncoder {
    public function encode(string $data, string $srcCodec, string $dstFormat): string {
        echo "[VideoEncoder] {$srcCodec} → {$dstFormat}\n";
        return 'encoded_video';
    }
}

class AudioEncoder {
    public function encode(string $data, string $srcCodec, string $dstFormat): string {
        echo "[AudioEncoder] {$srcCodec} → {$dstFormat}\n";
        return 'encoded_audio';
    }
}

class FileWriter {
    public function write(string $data, string $path): void {
        echo "[Writer] Записываю файл: {$path} (" . strlen($data) . " байт)\n";
    }
}

// TODO: реализовать фасад MediaConverter:
// - __construct() — создаёт экземпляры всех подсистем
// - convertVideo(string $src, string $targetFormat): string
//   1. Прочитать файл
//   2. Определить кодек источника
//   3. Перекодировать видео
//   4. Записать "{имя_без_расширения}.{targetFormat}"
//   Вернуть путь к выходному файлу
// - convertAudio(string $src, string $targetFormat): string
//   Аналогично, но через AudioEncoder

// Клиентский код
// $converter = new MediaConverter();
// $out1 = $converter->convertVideo('movie.avi', 'mp4');
// echo "Результат: {$out1}\n\n";
// $out2 = $converter->convertAudio('track.wav', 'mp3');
// echo "Результат: {$out2}\n";