Заместитель

<?php
/**
* Интерфейс Субъекта объявляет общие операции как для Реального Субъекта, так и
* для Заместителя. Пока клиент работает с Реальным Субъектом, используя этот
* интерфейс, вы сможете передать ему заместителя вместо реального субъекта.
*/

interface Subject
{
    public function request(): void;
}

/**
* Реальный Субъект содержит некоторую базовую бизнес-логику. Как правило,
* Реальные Субъекты способны выполнять некоторую полезную работу, которая к
* тому же может быть очень медленной или точной – например, коррекция входных
* данных. Заместитель может решить эти задачи без каких-либо изменений в коде
* Реального Субъекта.
*/

class RealSubject implements Subject
{
    public function request(): void
    {
        echo "RealSubject: Handling request.\n";
    }
}

/**
* Интерфейс Заместителя идентичен интерфейсу Реального Субъекта.
*/

class Proxy implements Subject
{
    /**
    * @var RealSubject
    */
    private $realSubject;

    /**
    * Заместитель хранит ссылку на объект класса РеальныйСубъект. Клиент может
    * либо лениво загрузить его, либо передать Заместителю.
    */
    public function __construct(RealSubject $realSubject)
    {
        $this->realSubject = $realSubject;
    }

    /**
    * Наиболее распространёнными областями применения паттерна Заместитель
    * являются ленивая загрузка, кэширование, контроль доступа, ведение журнала
    * и т.д. Заместитель может выполнить одну из этих задач, а затем, в
    * зависимости от результата, передать выполнение одноимённому методу в
    * связанном объекте класса Реального Субъект.
    */
    public function request(): void
    {
        if ($this->checkAccess()) {
            $this->realSubject->request();
            $this->logAccess();
        }
    }

    private function checkAccess(): bool
    {
        // Некоторые реальные проверки должны проходить здесь.
        echo "Proxy: Checking access prior to firing a real request.\n";

        return true;
    }

    private function logAccess(): void
    {
        echo "Proxy: Logging the time of request.\n";
    }
}

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

function clientCode(Subject $subject)
{
    // ...

    $subject->request();

    // ...
}

echo "Client: Executing the client code with a real subject:\n";
$realSubject = new RealSubject();
clientCode($realSubject);

echo "\n";

echo "Client: Executing the same client code with a proxy:\n";
$proxy = new Proxy($realSubject);
clientCode($proxy);

<?php
/**
* Интерфейс Субъекта описывает интерфейс реального объекта.
*
* Дело в том, что у большинства приложений нет чётко определённого интерфейса.
* В этом случае лучше было бы расширить Заместителя за счёт существующего
* класса приложения. Если это неудобно, тогда первым шагом должно быть
* извлечение правильного интерфейса.
*/

interface Downloader
{
    public function download(string $url): string;
}

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

class SimpleDownloader implements Downloader
{
    public function download(string $url): string
    {
        echo "Downloading a file from the Internet.\n";
        $result = file_get_contents($url);
        echo "Downloaded bytes: " . strlen($result) . "\n";

        return $result;
    }
}

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

class CachingDownloader implements Downloader
{
    /**
    * @var SimpleDownloader
    */
    private $downloader;

    /**
    * @var string[]
    */
    private $cache = [];

    public function __construct(SimpleDownloader $downloader)
    {
        $this->downloader = $downloader;
    }

    public function download(string $url): string
    {
        if (!isset($this->cache[$url])) {
            echo "CacheProxy MISS. ";
            $result = $this->downloader->download($url);
            $this->cache[$url] = $result;
        } else {
            echo "CacheProxy HIT. Retrieving result from cache.\n";
        }
        return $this->cache[$url];
    }
}

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

function clientCode(Downloader $subject)
{
    // ...
    $result = $subject->download("http://example.com/");
    // Повторяющиеся запросы на загрузку могут кэшироваться для увеличения
    // скорости.

    $result = $subject->download("http://example.com/");

    // ...
}

echo "Executing client code with real subject:\n";
$realSubject = new SimpleDownloader();
clientCode($realSubject);

echo "\n";

echo "Executing the same client code with a proxy:\n";
$proxy = new CachingDownloader($realSubject);
clientCode($proxy);

<?php
class User {
    public function __construct(
        public string $name,
        public string $role,  // "reader", "writer", "admin"
    ) {}
}

interface FileService {
    public function read(string $filename): string;
    public function write(string $filename, string $content): void;
    public function delete(string $filename): void;
}

class RealFileService implements FileService {
    private array $storage = [];

    public function read(string $filename): string {
        $content = $this->storage[$filename] ?? '';
        echo "[File] Читаю '{$filename}': " . substr($content, 0, 30) . "\n";
        return $content;
    }

    public function write(string $filename, string $content): void {
        $this->storage[$filename] = $content;
        echo "[File] Записываю '{$filename}' (" . strlen($content) . " байт)\n";
    }

    public function delete(string $filename): void {
        unset($this->storage[$filename]);
        echo "[File] Удаляю '{$filename}'\n";
    }
}

// TODO: реализовать SecureFileProxy implements FileService:
// - __construct(FileService $service, User $user)
// - read()   — разрешено для "reader", "writer", "admin"
//              иначе RuntimeException("Нет прав на чтение для роли '{$user->role}'")
// - write()  — разрешено для "writer", "admin"
// - delete() — только "admin"

// Клиентский код
// $real   = new RealFileService();
// $admin  = new SecureFileProxy($real, new User('Алиса', 'admin'));
// $reader = new SecureFileProxy($real, new User('Боб',   'reader'));
// $writer = new SecureFileProxy($real, new User('Вера',  'writer'));

// $admin->write('report.txt', 'Секретный отчёт');
// echo $reader->read('report.txt') . "\n";

// try {
//     $reader->write('report.txt', 'Попытка записи');
// } catch (RuntimeException $e) {
//     echo "Отказано: " . $e->getMessage() . "\n";
// }

<?php
interface Image {
    public function display(): void;
    public function getInfo(): array;
}

class HighResImage implements Image {
    private string $data;
    private int $width  = 3840;
    private int $height = 2160;

    public function __construct(private string $filepath) {
        echo "[Image] Загрузка из файла: {$filepath}\n";
        $this->data = "pixel_data_of_{$filepath}";
    }

    public function display(): void {
        echo "[Image] Отрисовка {$this->filepath} ({$this->width}x{$this->height})\n";
    }

    public function getInfo(): array {
        return ['file' => $this->filepath, 'width' => $this->width, 'height' => $this->height];
    }
}

// TODO: реализовать LazyImageProxy implements Image:
// - __construct(string $filepath) — сохраняет путь, НЕ загружает изображение
// - private load(): void — загружает HighResImage если ещё не загружено
// - display() — вызывает load(), затем делегирует
// - getInfo() — вызывает load(), затем делегирует
// - isLoaded(): bool

// Ожидаемый клиентский код:
// $images = array_map(fn($i) => new LazyImageProxy("photo_{$i}.jpg"), range(0, 99));
// echo "Создано " . count($images) . " прокси, реальных загрузок: 0\n";

// foreach (array_slice($images, 0, 3) as $img) {
//     $img->display();
// }

// $loadedCount = count(array_filter($images, fn($img) => $img->isLoaded()));
// echo "Загружено реально: {$loadedCount} из " . count($images) . "\n";

<?php
class User {
    public function __construct(
        public int    $id,
        public string $name,
        public string $email,
        public bool   $active = true,
    ) {}
}

interface UserService {
    public function getById(int $userId): ?User;
    public function getAll(): array;
    public function create(string $name, string $email): User;
    public function deactivate(int $userId): void;
}

class RealUserService implements UserService {
    private array $db;
    private int $nextId = 3;

    public function __construct() {
        $this->db = [
            1 => new User(1, 'Анна',  'anna@example.com'),
            2 => new User(2, 'Иван',  'ivan@example.com'),
        ];
    }

    public function getById(int $userId): ?User {
        usleep(10000);
        return $this->db[$userId] ?? null;
    }

    public function getAll(): array { usleep(20000); return array_values($this->db); }

    public function create(string $name, string $email): User {
        usleep(10000);
        $user = new User($this->nextId, $name, $email);
        $this->db[$this->nextId++] = $user;
        return $user;
    }

    public function deactivate(int $userId): void {
        usleep(10000);
        if (!isset($this->db[$userId])) throw new InvalidArgumentException("Пользователь #{$userId} не найден");
        $this->db[$userId]->active = false;
    }
}

// TODO: реализовать LoggingUserServiceProxy implements UserService:
// - __construct(UserService $service)
// - Каждый метод:
//   1. Логирует: "[LOG] Вызов {method}({args})"
//   2. Замеряет время
//   3. Делегирует в $service
//   4. Логирует результат или исключение с временем выполнения

// Клиентский код
// $service = new LoggingUserServiceProxy(new RealUserService());
// $user = $service->getById(1);
// $all  = $service->getAll();
// $new  = $service->create('Мария', 'maria@example.com');
// try {
//     $service->deactivate(999);
// } catch (InvalidArgumentException $e) {}

<?php
class WeatherData {
    public function __construct(
        public string $city,
        public float  $tempCelsius,
        public int    $humidity,
        public string $description,
    ) {}
}

interface WeatherService {
    public function getCurrent(string $city): WeatherData;
    public function getForecast(string $city, int $days): array;
}

class RealWeatherService implements WeatherService {
    private int $callCount = 0;

    public function getCurrent(string $city): WeatherData {
        $this->callCount++;
        usleep(50000);
        echo "[API] Запрос погоды для '{$city}' (вызов #{$this->callCount})\n";
        return new WeatherData($city, 20.5, 65, 'Ясно');
    }

    public function getForecast(string $city, int $days): array {
        $this->callCount++;
        usleep(100000);
        echo "[API] Запрос прогноза для '{$city}' на {$days} дней (вызов #{$this->callCount})\n";
        return array_map(fn($i) => new WeatherData($city, 18.0 + $i, 60 + $i, 'Переменная облачность'), range(0, $days - 1));
    }

    public function getCallCount(): int { return $this->callCount; }
}

// TODO: реализовать CachedWeatherProxy implements WeatherService:
// - __construct(WeatherService $service, float $ttl = 60.0)
// - getCurrent($city) — кэшировать по ключу "current:{$city}"
// - getForecast($city, $days) — кэшировать по ключу "forecast:{$city}:{$days}"
// - При cache hit: "[CACHE HIT] {key}"
// - getCacheStats(): array — ['hits' => N, 'misses' => N, 'cached_keys' => N]
// - invalidate(string $city): void — удалить все записи для города

// Ожидаемый клиентский код:
// $real  = new RealWeatherService();
// $proxy = new CachedWeatherProxy($real, ttl: 1.0);

// $proxy->getCurrent('Москва');     // MISS
// $proxy->getCurrent('Москва');     // HIT
// $proxy->getCurrent('СПб');        // MISS
// $proxy->getForecast('Москва', 3); // MISS
// $proxy->getForecast('Москва', 3); // HIT

// print_r($proxy->getCacheStats());
// echo "Реальных вызовов: " . $real->getCallCount() . "\n"; // 3

// sleep(2);
// $proxy->getCurrent('Москва');     // MISS — TTL истёк