Прототип

<?php
/**
* Пример класса, имеющего возможность клонирования. Мы посмотрим как происходит
* клонирование значений полей разных типов.
*/

class Prototype
{
    public $primitive;
    public $component;
    public $circularReference;

    /**
    * PHP имеет встроенную поддержку клонирования. Вы можете «клонировать»
    * объект без определения каких-либо специальных методов, при условии, что
    * его поля имеют примитивные типы. Поля, содержащие объекты, сохраняют свои
    * ссылки в клонированном объекте. Поэтому в некоторых случаях вам может
    * понадобиться клонировать также и вложенные объекты. Это можно сделать
    * специальным методом clone.
    */

    public function __clone()
    {
        $this->component = clone $this->component;

        // Клонирование объекта, который имеет вложенный объект с обратной
        // ссылкой, требует специального подхода. После завершения клонирования
        // вложенный объект должен указывать на клонированный объект, а не на
        // исходный объект.
        $this->circularReference = clone $this->circularReference;
        $this->circularReference->prototype = $this;
    }
}

class ComponentWithBackReference
{
    public $prototype;

    /**
     * Обратите внимание, что конструктор не будет выполнен во время
     * клонирования. Если у вас сложная логика внутри конструктора, вам может
     * потребоваться выполнить ее также и в методе clone.
     */
    public function __construct(Prototype $prototype)
    {
        $this->prototype = $prototype;
    }
}

/**
* Клиентский код.
*/

function clientCode()
{
    $p1 = new Prototype();
    $p1->primitive = 245;
    $p1->component = new \DateTime();
    $p1->circularReference = new ComponentWithBackReference($p1);

    $p2 = clone $p1;
    if ($p1->primitive === $p2->primitive) {
        echo "Primitive field values have been carried over to a clone. Yay!\n";
    } else {
        echo "Primitive field values have not been copied. Booo!\n";
    }
    if ($p1->component === $p2->component) {
        echo "Simple component has not been cloned. Booo!\n";
    } else {
        echo "Simple component has been cloned. Yay!\n";
    }

    if ($p1->circularReference === $p2->circularReference) {
        echo "Component with back reference has not been cloned. Booo!\n";
    } else {
        echo "Component with back reference has been cloned. Yay!\n";
    }

    if ($p1->circularReference->prototype === $p2->circularReference->prototype) {
        echo "Component with back reference is linked to original object. Booo!\n";
    } else {
        echo "Component with back reference is linked to the clone. Yay!\n";
    }
}

clientCode();

<?php
/**
* Прототип.
*/

class Page
{
    private $title;

    private $body;

    /**
    * @var Author
    */
    private $author;

    private $comments = [];

    /**
    * @var \DateTime
    */
    private $date;

    // +100 приватных полей.

    public function __construct(string $title, string $body, Author $author)
    {
        $this->title = $title;
        $this->body = $body;
        $this->author = $author;
        $this->author->addToPage($this);
        $this->date = new \DateTime();
    }

    public function addComment(string $comment): void
    {
        $this->comments[] = $comment;
    }

    /**
    * Вы можете контролировать, какие данные вы хотите перенести в
    * клонированный объект.
    *
    * Например, при клонировании страницы:
    * - Она получает новый заголовок «Копия ...».
    * - Автор страницы остаётся прежним. Поэтому мы оставляем ссылку на
    * существующий объект, добавляя клонированную страницу в список страниц
    * автора.
    * - Мы не переносим комментарии со старой страницы.
    * - Мы также прикрепляем к странице новый объект даты.
    */
    public function __clone()
    {
        $this->title = "Copy of " . $this->title;
        $this->author->addToPage($this);
        $this->comments = [];
        $this->date = new \DateTime();
    }
}

class Author
{
    private $name;

    /**
     * @var Page[]
     */
    private $pages = [];

    public function __construct(string $name)
    {
        $this->name = $name;
    }

    public function addToPage(Page $page): void
    {
        $this->pages[] = $page;
    }
}

/**
* Клиентский код.
*/
function clientCode()
{
    $author = new Author("John Smith");
    $page = new Page("Tip of the day", "Keep calm and carry on.", $author);

    // ...

    $page->addComment("Nice tip, thanks!");

    // ...

    $draft = clone $page;
    echo "Dump of the clone. Note that the author is now referencing two objects.\n\n";
    print_r($draft);
}

clientCode();

<?php
class Stats {
    public function __construct(
        public int $hp,
        public int $attack,
        public int $defense,
    ) {}
}

class Ability {
    public function __construct(
        public string $name,
        public int    $damage,
        public float  $cooldown,
    ) {}
}

class Character {
    public function __construct(
        public string $name,
        public int    $level,
        public Stats  $stats,
        /** @var Ability[] */
        public array  $abilities,
    ) {}

    public function __toString(): string {
        $abilities = implode(', ', array_map(fn($a) => $a->name, $this->abilities));
        return sprintf(
            "%s (ур.%d) | HP:%d ATK:%d | Способности: %s",
            $this->name, $this->level,
            $this->stats->hp, $this->stats->attack,
            $abilities
        );
    }

    // TODO: реализовать метод clone() с глубоким копированием через __clone()
}

// Проверка:
$original = new Character(
    name: 'Воин',
    level: 10,
    stats: new Stats(hp: 200, attack: 50, defense: 30),
    abilities: [new Ability('Удар меча', 80, 1.5), new Ability('Щитовой блок', 0, 3.0)],
);

// $clone = clone $original;
// $clone->name = 'Воин-клон';
// $clone->stats->hp = 150;
// $clone->abilities[0]->damage = 999;

// echo $original . "\n"; // HP и damage оригинала не должны измениться
// echo $clone . "\n";

<?php
interface Cloneable {
    public function cloneComponent(): static;
}

class Button implements Cloneable {
    public function __construct(
        public string $label,
        public string $color,
        public string $size,
        public bool   $disabled = false,
    ) {}

    public function cloneComponent(): static { return clone $this; }

    public function __toString(): string {
        $state = $this->disabled ? 'выкл.' : 'вкл.';
        return "Button[{$this->size}] '{$this->label}' ({$this->color}, {$state})";
    }
}

class Card implements Cloneable {
    public function __construct(
        public string $title,
        public array  $tags,
        public int    $elevation = 1,
    ) {}

    public function cloneComponent(): static { return clone $this; }

    public function __toString(): string {
        return "Card '{$this->title}' tags=[" . implode(', ', $this->tags) . "] elevation={$this->elevation}";
    }
}

// TODO: реализовать ComponentRegistry с методами:
// register(name, prototype), get(name) -> клон прототипа

// Ожидаемый клиентский код:
// $registry = new ComponentRegistry();
// $registry->register('primary_btn', new Button('ОК', 'blue', 'md'));
// $registry->register('danger_btn', new Button('Удалить', 'red', 'sm'));
//
// $btn1 = $registry->get('primary_btn');
// $btn1->label = 'Подтвердить';   // не меняет прототип в реестре
// $btn2 = $registry->get('primary_btn');
// echo $btn1 . "\n";  // Button[md] 'Подтвердить' (blue, вкл.)
// echo $btn2 . "\n";  // Button[md] 'ОК' (blue, вкл.)

<?php
class DatabaseConfig {
    public function __construct(
        public string $host,
        public int    $port,
        public string $name,
        public int    $poolSize,
    ) {}
}

class ServerConfig {
    public function __construct(
        public string         $host,
        public int            $port,
        public bool           $debug,
        public DatabaseConfig $db,
        public array          $allowedHosts,
        public array          $envVars,
    ) {}

    public function __toString(): string {
        return sprintf(
            "Server %s:%d debug=%s\n  DB: %s:%d/%s pool=%d\n  Hosts: [%s]\n  Env: %s",
            $this->host, $this->port, $this->debug ? 'true' : 'false',
            $this->db->host, $this->db->port, $this->db->name, $this->db->poolSize,
            implode(', ', $this->allowedHosts),
            json_encode($this->envVars)
        );
    }

    // TODO: реализовать глубокое клонирование через __clone()
}

// Базовый шаблон:
$base = new ServerConfig(
    host: '0.0.0.0', port: 8000, debug: false,
    db: new DatabaseConfig('db.internal', 5432, 'app_db', poolSize: 5),
    allowedHosts: ['localhost'],
    envVars: ['TZ' => 'UTC'],
);

// Ожидаемый клиентский код:
// $dev = clone $base;
// $dev->debug = true;
// $dev->db->name = 'app_db_dev';
// $dev->allowedHosts[] = 'dev.example.com';
//
// $prod = clone $base;
// $prod->port = 443;
// $prod->db->poolSize = 20;
//
// echo $base . "\n";  // db.name="app_db", poolSize=5, debug=false
// echo $dev . "\n";
// echo $prod . "\n";

<?php
class Metadata {
    public function __construct(
        public string   $author,
        public DateTime $createdAt,
        public int      $version,
    ) {}
}

class Document {
    private array $history = [];

    public function __construct(
        public string   $title,
        public string   $body,
        public array    $tags,
        public Metadata $metadata,
    ) {}

    public function edit(string $newBody): void {
        $this->history[] = $this->body;
        $this->body = $newBody;
    }

    public function getHistoryCount(): int { return count($this->history); }

    public function __toString(): string {
        return sprintf(
            "'%s' v%d by %s [%s]\nТеги: [%s] | История: %d изм.",
            $this->title, $this->metadata->version, $this->metadata->author,
            $this->metadata->createdAt->format('Y-m-d'),
            implode(', ', $this->tags),
            $this->getHistoryCount()
        );
    }

    // TODO: реализовать __clone() со следующей логикой:
    // - version += 1
    // - createdAt = new DateTime()
    // - history очищается
    // - tags и metadata копируются независимо
}

// Проверка:
// $original = new Document(
//     title: 'Введение в Python',
//     body: 'Python — это...',
//     tags: ['python', 'tutorial'],
//     metadata: new Metadata('Иван', new DateTime('2024-01-01'), 1),
// );
// $original->edit('Python — это отличный язык...');
//
// $draft = clone $original;
// $draft->title = 'Введение в Python (черновик)';
// $draft->tags[] = 'draft';
//
// echo $original . "\n";  // version=1, без "draft", history=1 изм.
// echo $draft . "\n";     // version=2, свежая дата, history=0 изм.