PHP: полный мануал с примерами, функциями и ООП

<?php
declare(strict_types=1);

class ProductCard { public string $title = 'Чай'; }
$draft = new ProductCard();
$copy = clone $draft;
$copy->title = 'Чёрный чай';
echo 'Оригинал: ', $draft->title, "\n";
echo 'Копия: ', $copy->title, "\n";

Оригинал: Чай
Копия: Чёрный чай

Слева новая переменная, справа clone исходного объекта. Если убрать слово clone, обе переменные дадут доступ к одной карточке, и изменение станет видно через обе.

<?php
declare(strict_types=1);

class Address { public string $city = 'Тула'; }
class Draft
{
    public function __construct(public Address $address) {}
}
$original = new Draft(new Address());
$copy = clone $original;
$copy->address->city = 'Казань';
echo 'Оригинал: ', $original->address->city, "\n";
echo 'Копия: ', $copy->address->city, "\n";

Оригинал: Казань
Копия: Казань

Draft уже два, Address пока один. Копирование свойства сохранило доступ к тому же вложенному объекту. Такая ошибка — реальная причина вопросов о копировании объектов; следующий шаг разрывает именно эту связь.

<?php
declare(strict_types=1);

class Address { public string $city = 'Тула'; }
class Draft
{
    public function __construct(public Address $address) {}
    public function __clone(): void { $this->address = clone $this->address; }
}
$original = new Draft(new Address());
$copy = clone $original;
$copy->address->city = 'Казань';
echo 'Оригинал: ', $original->address->city, "\n";
echo 'Копия: ', $copy->address->city, "\n";

Оригинал: Тула
Копия: Казань

В __clone переменная $this — новая копия Draft. Она получает свою копию Address. Метод не заменяет встроенное клонирование и не вызывает конструктор заново. Если у родителя есть нужная очистка в __clone, собственный метод потомка должен вызвать её явно.

<?php
declare(strict_types=1);

final class Offer
{
    public function __construct(public readonly int $priceKopecks)
    {
        if ($priceKopecks < 0) { throw new InvalidArgumentException('Отрицательная цена'); }
    }
    public function withPrice(int $priceKopecks): self
    {
        if ($priceKopecks < 0) { throw new InvalidArgumentException('Отрицательная цена'); }
        return clone($this, ['priceKopecks' => $priceKopecks]);
    }
}
$original = new Offer(25900);
$discounted = $original->withPrice(23900);
echo 'Было: ', $original->priceKopecks, " коп.\n";
echo 'Предложение: ', $discounted->priceKopecks, " коп.\n";

Было: 25900 коп.
Предложение: 23900 коп.

PHP 8.5: второй аргумент clone — массив заменяемых свойств. Замены применяются после __clone и соблюдают видимость. Конструктор заново не запускается, поэтому withPrice повторяет проверку входа. Для PHP 8.2–8.4 здесь достаточно return new self($priceKopecks), что также повторно использует конструктор.

<?php
declare(strict_types=1);

class MutableExportOptions
{
    public string $format = 'csv';
}

class ExportSnapshot
{
    public function __construct(public readonly MutableExportOptions $options) {}

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

$original = new ExportSnapshot(new MutableExportOptions());
$copy = clone $original;
$copy->options->format = 'json';
echo $original->options->format, ', ', $copy->options->format, "\n";
echo $original->options === $copy->options ? "Общая настройка\n" : "Настройки разделены\n";
try {
    $copy->options = new MutableExportOptions();
} catch (Error $error) {
    echo "Повторная обычная запись запрещена\n";
}

csv, json
Настройки разделены
Повторная обычная запись запрещена

В __clone переинициализировано свойство нового ExportSnapshot. Значение оригинала не переприсваивалось. Вложенный format всё ещё изменяем, потому что readonly относится к внешнему свойству options, а не ко всему графу объектов.