Мост

<?php
/**
* Абстракция устанавливает интерфейс для «управляющей» части двух иерархий
* классов. Она содержит ссылку на объект из иерархии Реализации и делегирует
* ему всю настоящую работу.
*/

class Abstraction
{
    /**
    * @var Implementation
    */
    protected $implementation;

    public function __construct(Implementation $implementation)
    {
        $this->implementation = $implementation;
    }

    public function operation(): string
    {
        return "Abstraction: Base operation with:\n" .
            $this->implementation->operationImplementation();
    }
}

/**
* Можно расширить Абстракцию без изменения классов Реализации.
*/

class ExtendedAbstraction extends Abstraction
{
    public function operation(): string
    {
        return "ExtendedAbstraction: Extended operation with:\n" .
            $this->implementation->operationImplementation();
    }
}

/**
* Реализация устанавливает интерфейс для всех классов реализации. Он не должен
* соответствовать интерфейсу Абстракции. На практике оба интерфейса могут быть
* совершенно разными. Как правило, интерфейс Реализации предоставляет только
* примитивные операции, в то время как Абстракция определяет операции более
* высокого уровня, основанные на этих примитивах.
*/

interface Implementation
{
    public function operationImplementation(): string;
}

/**
* Каждая Конкретная Реализация соответствует определённой платформе и реализует
* интерфейс Реализации с использованием API этой платформы.
*/

class ConcreteImplementationA implements Implementation
{
    public function operationImplementation(): string
    {
        return "ConcreteImplementationA: Here's the result on the platform A.\n";
    }
}

class ConcreteImplementationB implements Implementation
{
    public function operationImplementation(): string
    {
        return "ConcreteImplementationB: Here's the result on the platform B.\n";
    }
}

/**
* За исключением этапа инициализации, когда объект Абстракции связывается с
* определённым объектом Реализации, клиентский код должен зависеть только от
* класса Абстракции. Таким образом, клиентский код может поддерживать любую
* комбинацию абстракции и реализации.
*/

function clientCode(Abstraction $abstraction)
{
    // ...

    echo $abstraction->operation();

    // ...
}

/**
* Клиентский код должен работать с любой предварительно сконфигурированной
* комбинацией абстракции и реализации.
*/
$implementation = new ConcreteImplementationA();
$abstraction = new Abstraction($implementation);
clientCode($abstraction);

echo "\n";

$implementation = new ConcreteImplementationB();
$abstraction = new ExtendedAbstraction($implementation);
clientCode($abstraction);

<?php
/**
* Абстракция.
*/

abstract class Page
{
    /**
    * @var Renderer
    */
    protected $renderer;

    /**
    * Обычно Абстракция инициализируется одним из объектов Реализации.
    */
    public function __construct(Renderer $renderer)
    {
        $this->renderer = $renderer;
    }

    /**
    * Паттерн Мост позволяет динамически заменять присоединённый объект
    * Реализации.
    */
    public function changeRenderer(Renderer $renderer): void
    {
        $this->renderer = $renderer;
    }

    /**
    * Поведение «вида» остаётся абстрактным, так как оно предоставляется только
    * классами Конкретной Абстракции.
    */
    abstract public function view(): string;
}

/**
* Эта Конкретная Абстракция создаёт простую страницу.
*/

class SimplePage extends Page
{
    protected $title;
    protected $content;

    public function __construct(Renderer $renderer, string $title, string $content)
    {
        parent::__construct($renderer);
        $this->title = $title;
        $this->content = $content;
    }

    public function view(): string
    {
        return $this->renderer->renderParts([
            $this->renderer->renderHeader(),
            $this->renderer->renderTitle($this->title),
            $this->renderer->renderTextBlock($this->content),
            $this->renderer->renderFooter()
        ]);
    }
}

/**
* Эта Конкретная Абстракция создаёт более сложную страницу.
*/

class ProductPage extends Page
{
    protected $product;

    public function __construct(Renderer $renderer, Product $product)
    {
        parent::__construct($renderer);
        $this->product = $product;
    }

    public function view(): string
    {
        return $this->renderer->renderParts([
            $this->renderer->renderHeader(),
            $this->renderer->renderTitle($this->product->getTitle()),
            $this->renderer->renderTextBlock($this->product->getDescription()),
            $this->renderer->renderImage($this->product->getImage()),
            $this->renderer->renderLink("/cart/add/" . $this->product->getId(), "Add to cart"),
            $this->renderer->renderFooter()
        ]);
    }
}

/**
* Вспомогательный класс для класса ProductPage.
*/

class Product
{
    private $id, $title, $description, $image, $price;

    public function __construct(
        string $id,
        string $title,
        string $description,
        string $image,
        float $price
    ) {
        $this->id = $id;
        $this->title = $title;
        $this->description = $description;
        $this->image = $image;
        $this->price = $price;
    }

    public function getId(): string { return $this->id; }

    public function getTitle(): string { return $this->title; }

    public function getDescription(): string { return $this->description; }

    public function getImage(): string { return $this->image; }

    public function getPrice(): float { return $this->price; }
}


/**
* Реализация объявляет набор «реальных», «под капотом», «платформенных»
* методов.
*
* В этом случае Реализация перечисляет методы рендеринга, которые используются
* для создания веб-страниц. Разные Абстракции могут использовать разные методы
* Реализации.
*/

interface Renderer
{
    public function renderTitle(string $title): string;

    public function renderTextBlock(string $text): string;

    public function renderImage(string $url): string;

    public function renderLink(string $url, string $title): string;

    public function renderHeader(): string;

    public function renderFooter(): string;

    public function renderParts(array $parts): string;
}

/**
* Эта Конкретная Реализация отображает веб-страницу в виде HTML.
*/

class HTMLRenderer implements Renderer
{
    public function renderTitle(string $title): string
    {
        return "<h1>$title</h1>";
    }

    public function renderTextBlock(string $text): string
    {
        return "<div class='text'>$text</div>";
    }

    public function renderImage(string $url): string
    {
        return "<img src='$url'>";
    }

    public function renderLink(string $url, string $title): string
    {
        return "<a href='$url'>$title</a>";
    }

    public function renderHeader(): string
    {
        return "<html><body>";
    }

    public function renderFooter(): string
    {
        return "</body></html>";
    }

    public function renderParts(array $parts): string
    {
        return implode("\n", $parts);
    }
}

/**
* Эта Конкретная Реализация отображает веб-страницу в виде строк JSON.
*/

class JsonRenderer implements Renderer
{
    public function renderTitle(string $title): string
    {
        return '"title": "' . $title . '"';
    }

    public function renderTextBlock(string $text): string
    {
        return '"text": "' . $text . '"';
    }

    public function renderImage(string $url): string
    {
        return '"img": "' . $url . '"';
    }

    public function renderLink(string $url, string $title): string
    {
        return '"link": {"href": "' . $url . '", "title": "' . $title . '"}';
    }

    public function renderHeader(): string
    {
        return '';
    }

    public function renderFooter(): string
    {
        return '';
    }

    public function renderParts(array $parts): string
    {
        return "{\n" . implode(",\n", array_filter($parts)) . "\n}";
    }
}

/**
* Клиентский код имеет дело только с объектами Абстракции.
*/

function clientCode(Page $page)
{
    // ...

    echo $page->view();

    // ...
}

/**
* Клиентский код может выполняться с любой предварительно сконфигурированной
* комбинацией Абстракция+Реализация.
*/
$HTMLRenderer = new HTMLRenderer();
$JSONRenderer = new JsonRenderer();

$page = new SimplePage($HTMLRenderer, "Home", "Welcome to our website!");
echo "HTML view of a simple content page:\n";
clientCode($page);
echo "\n\n";

/**
* При необходимости Абстракция может заменить связанную Реализацию во время
* выполнения.
*/
$page->changeRenderer($JSONRenderer);
echo "JSON view of a simple content page, rendered with the same client code:\n";
clientCode($page);
echo "\n\n";


$product = new Product("123", "Star Wars, episode1",
    "A long time ago in a galaxy far, far away...",
    "/images/star-wars.jpeg", 39.95);

$page = new ProductPage($HTMLRenderer, $product);
echo "HTML view of a product page, same client code:\n";
clientCode($page);
echo "\n\n";

$page->changeRenderer($JSONRenderer);
echo "JSON view of a simple content page, with the same client code:\n";
clientCode($page);

<?php
// Без паттерна — взрыв подклассов
class RasterCircle {
    public function __construct(
        private float $x, private float $y, private float $radius
    ) {}

    public function draw(): string {
        return "Raster: рисую круг в ({$this->x},{$this->y}) r={$this->radius}";
    }
}

class VectorCircle {
    public function __construct(
        private float $x, private float $y, private float $radius
    ) {}

    public function draw(): string {
        return "Vector: рисую круг в ({$this->x},{$this->y}) r={$this->radius}";
    }
}

class RasterRectangle {
    public function __construct(
        private float $x, private float $y, private float $w, private float $h
    ) {}

    public function draw(): string {
        return "Raster: рисую прямоугольник в ({$this->x},{$this->y}) {$this->w}x{$this->h}";
    }
}

class VectorRectangle {
    public function __construct(
        private float $x, private float $y, private float $w, private float $h
    ) {}

    public function draw(): string {
        return "Vector: рисую прямоугольник в ({$this->x},{$this->y}) {$this->w}x{$this->h}";
    }
}

// TODO: применить паттерн Мост:
// 1. Создать интерфейс Renderer с методами drawCircle() и drawRectangle()
// 2. Реализовать RasterRenderer и VectorRenderer
// 3. Создать абстрактный класс Shape со ссылкой на Renderer
// 4. Реализовать Circle, Rectangle (и Triangle — без изменения рендереров!)

<?php
// Реализация — иерархия устройств
interface Device {
    public function isEnabled(): bool;
    public function enable(): void;
    public function disable(): void;
    public function getVolume(): int;
    public function setVolume(int $volume): void;
    public function getChannel(): int;
    public function setChannel(int $channel): void;
}

// TODO: реализовать конкретные устройства:
// TV и Radio (каждое хранит своё состояние: enabled, volume, channel)

// TODO: реализовать иерархию пультов (Абстракция):
// BasicRemote — togglePower(), volumeUp(), volumeDown(), channelUp(), channelDown()
// AdvancedRemote extends BasicRemote — mute(), setChannel(int n)

// Ожидаемый клиентский код:
// $tv = new TV();
// $remote = new BasicRemote($tv);
// $remote->togglePower();
// $remote->volumeUp();
// $remote->volumeUp();
// echo "TV: вкл=" . ($tv->isEnabled() ? 'да' : 'нет') . ", громкость={$tv->getVolume()}\n";

// $radio = new Radio();
// $advanced = new AdvancedRemote($radio);
// $advanced->togglePower();
// $advanced->setChannel(7);
// $advanced->mute();
// echo "Radio: канал={$radio->getChannel()}, громкость={$radio->getVolume()}\n";

<?php
// Реализация — иерархия каналов доставки
interface MessageSender {
    public function send(string $recipient, string $subject, string $body): void;
}

class EmailSender implements MessageSender {
    public function send(string $recipient, string $subject, string $body): void {
        echo "[Email → {$recipient}] Тема: {$subject}\n{$body}\n";
    }
}

class SmsSender implements MessageSender {
    public function send(string $recipient, string $subject, string $body): void {
        echo "[SMS → {$recipient}] {$subject}: " . substr($body, 0, 70) . "\n";
    }
}

class TelegramSender implements MessageSender {
    public function send(string $recipient, string $subject, string $body): void {
        echo "[Telegram → {$recipient}]\n*{$subject}*\n{$body}\n";
    }
}

// TODO: реализовать иерархию уведомлений (Абстракция):
// Notification(sender) — базовый класс с методом notify(recipient, title, message)
// RegularNotification  — отправляет как есть
// UrgentNotification   — добавляет "СРОЧНО:" к теме и "НЕМЕДЛЕННО: " к телу
// ScheduledNotification(sender, sendAt) — добавляет в тело время запланированной отправки

// Ожидаемый клиентский код:
// $urgent = new UrgentNotification(new EmailSender());
// $urgent->notify('[email protected]', 'Сервер упал', 'Требуется немедленное вмешательство');

// $scheduled = new ScheduledNotification(new TelegramSender(), '2025-12-31 23:59');
// $scheduled->notify('@channel', 'С Новым годом!', 'Поздравляем всю команду!');

<?php
// Реализация — иерархия форматов экспорта
interface Exporter {
    public function exportHeader(string $title): string;
    public function exportRow(string $label, string $value): string;
    public function exportFooter(string $summary): string;
}

class CsvExporter implements Exporter {
    public function exportHeader(string $title): string { return "# {$title}\nlabel,value"; }
    public function exportRow(string $label, string $value): string { return "{$label},{$value}"; }
    public function exportFooter(string $summary): string { return "# {$summary}"; }
}

class HtmlExporter implements Exporter {
    public function exportHeader(string $title): string { return "<h1>{$title}</h1><table>"; }
    public function exportRow(string $label, string $value): string {
        return "<tr><td>{$label}</td><td>{$value}</td></tr>";
    }
    public function exportFooter(string $summary): string { return "</table><p>{$summary}</p>"; }
}

// TODO: реализовать иерархию отчётов (Абстракция):
// Report(exporter) — базовый класс с методом generate(): string
// FinancialReport(exporter, data: array)   — статьи доходов/расходов + итог
// StatisticalReport(exporter, data: array) — метрики с единицами измерения
// AuditReport(exporter, events: array)     — список событий с датами

// Добавьте JsonExporter (новый формат) без изменения классов отчётов.

// Ожидаемый клиентский код:
// $data = ['Выручка' => 500000, 'Расходы' => 320000, 'Прибыль' => 180000];
// $report = new FinancialReport(new CsvExporter(), $data);
// echo $report->generate();

// $report2 = new FinancialReport(new HtmlExporter(), $data);
// echo $report2->generate();