Декоратор

<?php
/**
* Базовый интерфейс Компонента определяет поведение, которое изменяется
* декораторами.
*/

interface Component
{
    public function operation(): string;
}

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

class ConcreteComponent implements Component
{
    public function operation(): string
    {
        return "ConcreteComponent";
    }
}

/**
* Базовый класс Декоратора следует тому же интерфейсу, что и другие компоненты.
* Основная цель этого класса - определить интерфейс обёртки для всех конкретных
* декораторов. Реализация кода обёртки по умолчанию может включать в себя поле
* для хранения завёрнутого компонента и средства его инициализации.
*/

class Decorator implements Component
{
    /**
    * @var Component
    */
    protected $component;

    public function __construct(Component $component)
    {
        $this->component = $component;
    }

    /**
    * Декоратор делегирует всю работу обёрнутому компоненту.
    */
    public function operation(): string
    {
        return $this->component->operation();
    }
}

/**
* Конкретные Декораторы вызывают обёрнутый объект и изменяют его результат
* некоторым образом.
*/

class ConcreteDecoratorA extends Decorator
{
    /**
    * Декораторы могут вызывать родительскую реализацию операции, вместо того,
    * чтобы вызвать обёрнутый объект напрямую. Такой подход упрощает расширение
    * классов декораторов.
    */
    public function operation(): string
    {
        return "ConcreteDecoratorA(" . parent::operation() . ")";
    }
}

/**
* Декораторы могут выполнять своё поведение до или после вызова обёрнутого
* объекта.
*/

class ConcreteDecoratorB extends Decorator
{
    public function operation(): string
    {
        return "ConcreteDecoratorB(" . parent::operation() . ")";
    }
}

/**
* Клиентский код работает со всеми объектами, используя интерфейс Компонента.
* Таким образом, он остаётся независимым от конкретных классов компонентов, с
* которыми работает.
*/

function clientCode(Component $component)
{
    // ...
    echo "RESULT: " . $component->operation();
    // ...
}

/**
* Таким образом, клиентский код может поддерживать как простые компоненты...
*/

$simple = new ConcreteComponent();
echo "Client: I've got a simple component:\n";
clientCode($simple);
echo "\n\n";

/**
* ...так и декорированные.
*
* Обратите внимание, что декораторы могут обёртывать не только простые
* компоненты, но и другие декораторы.
*/
$decorator1 = new ConcreteDecoratorA($simple);
$decorator2 = new ConcreteDecoratorB($decorator1);
echo "Client: Now I've got a decorated component:\n";
clientCode($decorator2);

<?php

/**
* Интерфейс Компонента объявляет метод фильтрации, который должен быть
* реализован всеми конкретными компонентами и декораторами.
*/

interface InputFormat
{
    public function formatText(string $text): string;
}

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

class TextInput implements InputFormat
{
    public function formatText(string $text): string
    {
        return $text;
    } 
}

/**
* Базовый класс Декоратора не содержит реальной логики фильтрации или
* форматирования. Его основная цель – реализовать базовую
* инфраструктуру декорирования: поле для хранения обёрнутого
* компонента или другого декоратора и базовый метод форматирования,
* который делегирует работу обёрнутому объекту.
* Реальная работа по форматированию выполняется подклассами.
*/

class TextFormat implements InputFormat
{
    /**
    * @var InputFormat
    */
    protected $inputFormat;

    public function __construct(InputFormat $inputFormat)
    {
        $this->inputFormat = $inputFormat;
    }

    /**
    * Декоратор делегирует всю работу обёрнутому компоненту.
    */
    public function formatText(string $text): string
    {
        return $this->inputFormat->formatText($text);
    }
}

/**
* Этот Конкретный Декоратор удаляет все теги HTML из данного текста.
*/

class PlainTextFilter extends TextFormat
{
    public function formatText(string $text): string
    {
        $text = parent::formatText($text);
        return strip_tags($text);
    }
}

/**
* Этот Конкретный Декоратор удаляет только опасные теги и атрибуты
* HTML, которые могут привести к XSS-уязвимости.
*/

class DangerousHTMLTagsFilter extends TextFormat
{
    private $dangerousTagPatterns = [
        "|<script.*?>([\s\S]*)?</script>|i", // ...
    ];

    private $dangerousAttributes = [
        "onclick", "onkeypress", // ...
    ];

    public function formatText(string $text): string
    {
        $text = parent::formatText($text);

        foreach ($this->dangerousTagPatterns as $pattern) {
            $text = preg_replace($pattern, '', $text);
        }

        foreach ($this->dangerousAttributes as $attribute) {
            $text = preg_replace_callback('|<(.*?)>|',
                function ($matches) use ($attribute) {
                    $result = preg_replace("|$attribute=|i", '',
                        $matches[1]);
                    return "<" . $result . ">";
                }, $text);
        }

        return $text;
    }
}

/**
* Этот Конкретный Декоратор предоставляет элементарное преобразование
* Markdown → HTML.
*/

class MarkdownFormat extends TextFormat
{
    public function formatText(string $text): string
    {
        $text = parent::formatText($text);

        // Форматирование элементов блока.
        $chunks = preg_split('|\n\n|', $text);
        foreach ($chunks as &$chunk) {
            // Форматирование заголовков.
            if (preg_match('|^#+|', $chunk)) {
                $chunk = preg_replace_callback('|^(#+)(.*?)$|',
                    function ($matches) {
                        $h = strlen($matches[1]);
                        return "<h$h>" . trim($matches[2]) . "</h$h>";
                    }, $chunk);
            } // Форматирование параграфов.
            else {
                $chunk = "<p>$chunk</p>";
            }
        }
        $text = implode("\n\n", $chunks);

        // Форматирование встроенных элементов.
        $text = preg_replace("|__(.*?)__|", '<strong>$1</strong>',
            $text);
        $text = preg_replace("|\*\*(.*?)\*\*|", '<strong>$1</strong>',
            $text);
        $text = preg_replace("|_(.*?)_|", '<em>$1</em>', $text);
        $text = preg_replace("|\*(.*?)\*|", '<em>$1</em>', $text);

        return $text;
    }
}

/**
* Клиентский код может быть частью реального веб-сайта, который
* отображает создаваемый пользователями контент. Поскольку он работает
* с модулями форматирования через интерфейс компонента, ему всё равно,
* получает ли он простой объект компонента или обёрнутый.
*/ 

function displayCommentAsAWebsite(InputFormat $format, string $text)
{
    // ..
    echo $format->formatText($text);
    // ..
}

/**
* Модули форматирования пользовательского ввода очень удобны при
* работе с контентом, создаваемым пользователями. Отображение такого
* контента «как есть» может быть очень опасным, особенно когда его
* могут создавать анонимные пользователи (например, комментарии).
* Ваш сайт не только рискует получить массу спам-ссылок, но также
* может быть подвергнут XSS-атакам.
*/

$dangerousComment = <<<HERE
    Hello! Nice blog post!
    Please visit my
    <a href='http://www.iwillhackyou.com'>homepage</a>.
    <script src="http://www.iwillhackyou.com/script.js">
        performXSSAttack();
    </script>
HERE;

/**
* Наивное отображение комментариев (небезопасное).
*/

$naiveInput = new TextInput();
echo "Website renders comments without filtering (unsafe):\n";
displayCommentAsAWebsite($naiveInput, $dangerousComment);
echo "\n\n\n";

/**
* Отфильтрованное отображение комментариев (безопасное).
*/

$filteredInput = new PlainTextFilter($naiveInput);
echo "Website renders comments after stripping all tags (safe):\n";
displayCommentAsAWebsite($filteredInput, $dangerousComment);
echo "\n\n\n";


/**
* Декоратор позволяет складывать несколько входных форматов для
* получения точного контроля над отображаемым содержимым.
*/
$dangerousForumPost = <<<HERE
    # Welcome
    This is my first post on this **gorgeous** forum.
    <script src="http://www.iwillhackyou.com/script.js">
        performXSSAttack();
    </script>
HERE;

/**
* Наивное отображение сообщений (небезопасное, без форматирования).
*/

$naiveInput = new TextInput();
echo "Website renders a forum post without filtering and formatting (unsafe, ugly):\n";
displayCommentAsAWebsite($naiveInput, $dangerousForumPost);
echo "\n\n\n";

/**
* Форматтер Markdown + фильтрация опасных тегов (безопасно, красиво).
*/

$text = new TextInput();
$markdown = new MarkdownFormat($text);
$filteredInput = new DangerousHTMLTagsFilter($markdown);
echo "Website renders a forum post after translating markdown markup" .
    "and filtering some dangerous HTML tags and attributes (safe, pretty):\n";
displayCommentAsAWebsite($filteredInput, $dangerousForumPost);
echo "\n\n\n";

<?php
interface Message {
    public function getContent(): string;
}

class TextMessage implements Message {
    public function __construct(private string $content) {}
    public function getContent(): string { return $this->content; }
}

abstract class MessageDecorator implements Message {
    public function __construct(protected Message $wrapped) {}
    public function getContent(): string { return $this->wrapped->getContent(); }
}

// TODO: реализовать декораторы:
// UpperCaseDecorator  — strtoupper(getContent())
// TrimDecorator       — trim(getContent())
// CensorDecorator(wrapped, array $bannedWords)
//   — заменяет каждое слово из $bannedWords на "***" (без учёта регистра)
// LengthLimitDecorator(wrapped, int $maxLen)
//   — обрезает до $maxLen символов, добавляя "..." если текст был длиннее

// Ожидаемый клиентский код:
// $raw = new TextMessage('  Привет, это спам и реклама!  ');
// $processed = new LengthLimitDecorator(
//     new CensorDecorator(
//         new TrimDecorator($raw),
//         bannedWords: ['спам', 'реклама']
//     ),
//     maxLen: 25
// );
// echo $processed->getContent(); // "Привет, это *** и ***!"

<?php
class Request {
    public function __construct(
        public string $method,
        public string $url,
        public array  $headers = [],
        public string $body = '',
    ) {}
}

class Response {
    public function __construct(
        public int    $status,
        public string $body,
    ) {}

    public function isOk(): bool { return $this->status >= 200 && $this->status < 300; }
}

interface HttpClient {
    public function send(Request $request): Response;
}

class BaseHttpClient implements HttpClient {
    public function send(Request $request): Response {
        echo "  [HTTP] {$request->method} {$request->url}\n";
        return new Response(200, '{"result": "ok"}');
    }
}

abstract class HttpClientDecorator implements HttpClient {
    public function __construct(protected HttpClient $client) {}
    public function send(Request $request): Response { return $this->client->send($request); }
}

// TODO: реализовать декораторы:
// AuthDecorator(client, string $token)
//   — добавляет $request->headers['Authorization'] = "Bearer {$token}"
// LoggingDecorator(client)
//   — до запроса: "[LOG] Sending {method} {url}"
//   — после: "[LOG] Response {status}"
// RetryDecorator(client, int $retries = 3)
//   — при !isOk() — повторяет до $retries раз
// CachingDecorator(client)
//   — кэширует ответы GET-запросов по url; повторный запрос возвращает кэш

// Ожидаемый клиентский код:
// $client = new CachingDecorator(
//     new LoggingDecorator(
//         new AuthDecorator(
//             new RetryDecorator(new BaseHttpClient(), retries: 2),
//             token: 'my-secret-token'
//         )
//     )
// );
// $r1 = $client->send(new Request('GET', 'https://api.example.com/users'));
// $r2 = $client->send(new Request('GET', 'https://api.example.com/users')); // из кэша

<?php
interface DataStream {
    public function write(string $data): void;
    public function read(): string;
}

class FileDataStream implements DataStream {
    private string $storage = '';

    public function write(string $data): void {
        $this->storage = $data;
        echo "  [File] Записано " . strlen($data) . " байт\n";
    }

    public function read(): string { return $this->storage; }
}

abstract class DataStreamDecorator implements DataStream {
    public function __construct(protected DataStream $stream) {}
    public function write(string $data): void { $this->stream->write($data); }
    public function read(): string { return $this->stream->read(); }
}

// TODO: реализовать декораторы:
// EncryptionDecorator(stream, int $key = 42)
//   — write: XOR каждый символ с $key через array_map + chr/ord, затем в stream
//   — read: читает из stream, XOR обратно
//
// CompressionDecorator(stream)
//   — write: base64_encode($data), затем в stream
//   — read: base64_decode($stream->read())
//
// BufferedDecorator(stream, int $bufferSize = 64)
//   — write: накапливает в буфере; сбрасывает в stream когда буфер >= $bufferSize
//   — flush(): принудительно сбрасывает остаток буфера

// Ожидаемый клиентский код:
// $stream = new EncryptionDecorator(
//     new CompressionDecorator(
//         new FileDataStream()
//     )
// );
// $original = 'Секретные данные пользователя';
// $stream->write($original);
// $result = $stream->read();
// echo "Данные совпадают: " . ($result === $original ? 'да' : 'нет') . "\n";

<?php
class ValidationResult {
    private array $errors;

    public function __construct(array $errors = []) {
        $this->errors = $errors;
    }

    public function isValid(): bool { return empty($this->errors); }
    public function getErrors(): array { return $this->errors; }

    public function merge(ValidationResult $other): self {
        return new self(array_merge($this->errors, $other->getErrors()));
    }
}

interface Validator {
    public function validate(string $value): ValidationResult;
}

class BaseValidator implements Validator {
    public function validate(string $value): ValidationResult {
        return new ValidationResult(); // базовый всегда проходит
    }
}

abstract class ValidatorDecorator implements Validator {
    public function __construct(protected Validator $validator) {}

    public function validate(string $value): ValidationResult {
        return $this->validator->validate($value);
    }
}

// TODO: реализовать декораторы (каждый добавляет ошибки к результату обёрнутого):
// RequiredDecorator   — "Поле обязательно для заполнения" если trim($value) === ""
// MinLengthDecorator(validator, int $minLen)
//   — "Минимальная длина: {$minLen} символов"
// MaxLengthDecorator(validator, int $maxLen)
//   — "Максимальная длина: {$maxLen} символов"
// RegexDecorator(validator, string $pattern, string $message)
//   — $message если !preg_match($pattern, $value)
// EmailDecorator — использует RegexDecorator с паттерном email

// Ожидаемый клиентский код:
// $emailValidator = new EmailDecorator(
//     new RequiredDecorator(
//         new MaxLengthDecorator(new BaseValidator(), maxLen: 50)
//     )
// );
// foreach (['', 'not-an-email', str_repeat('a', 51), '[email protected]'] as $value) {
//     $result = $emailValidator->validate($value);
//     $status = $result->isValid() ? 'OK' : 'Ошибки: ' . implode(', ', $result->getErrors());
//     echo "'{$value}': {$status}\n";
// }