PHP readonly 属性在 clone 后如何初始化

在 PHP 8.3 及以上，如果对象需要通过 clone 生成一份“身份不同、字段大体相同”的副本，可以在 __clone() 中给副本的 readonly 属性重新写入一次。关键点是：这次写入只发生在克隆出来的对象上，而且只能使用这个克隆阶段提供的一次写入窗口。

例如，编辑器复制一份草稿时，标题、模板和内容可以沿用原对象，但持久化 ID 应该清空。不要在外部直接给 readonly 属性赋值；把副本需要变化的字段集中放进 __clone()，并先确认运行环境至少是 PHP 8.3。

先分清 clone 的复制阶段和写入窗口

普通对象克隆可以按三个概念理解：先由 clone 创建副本并复制属性值，再自动调用副本的 __clone()，最后得到一个可以继续使用的新对象。PHP 8.3 的变化是，副本进入 __clone() 后，类内部可以重新初始化 readonly 属性。

因此，__clone() 不是让 readonly 变成普通可写属性，而是给“对象生命周期中的克隆副本”增加了一个受限的重初始化时机。原对象不会因为克隆而被改写。

用 __clone 清空副本的只读 ID

下面的场景是复制一份草稿继续编辑。原草稿的 $id 已经代表数据库记录，副本不能继续携带同一个 ID，否则保存时容易把“新草稿”误当成更新原记录。

id = null;
    }
}

$origin = new Draft('接口设计草稿', 42);
$copy = clone $origin;

// 原对象保留数据库身份，副本拥有独立的“未保存”状态。
echo $origin->id; // 42
var_dump($copy->id); // NULL

这里的赋值必须写在类的 __clone() 中。把 $copy->id = null 放在类外，或者放到普通方法里，都会违反 readonly 的访问规则。clone 关键字本身也不会重新执行构造器，所以不能指望构造器自动生成新的 ID。

需要留意：clone 后不是任意次数都能赋值

一次克隆只给当前副本一次重初始化机会。下面这种写法把同一个属性写了两次，第二次没有额外权限：

public function __clone(): void
{
    // 第一次写入已经完成副本的重初始化。
    $this->id = null;

    // 错误：同一个克隆副本不能再次修改 readonly 属性。
    // $this->id = 0;
}

也不要用引用绕过规则：

public function __clone(): void
{
    // PHP 8.4+ 不允许通过引用对 readonly 属性做间接修改。
    // $ref = &$this->id;
    // $ref = null;

    // 直接、明确地完成唯一一次写入。
    $this->id = null;
}

把所有需要改变的副本字段集中计算后再一次性写入，通常比在 __clone() 中分散修改更容易维护。若字段需要多个派生值，先在局部变量里完成计算，最后分别对不同的 readonly 属性各写一次。

对象属性要手动做深拷贝

readonly 锁住的是属性槽位，不等于锁住对象内部的全部状态。如果 readonly 属性保存的是一个可变对象，普通 clone 仍可能让原对象和副本指向同一个内部对象。要隔离这段状态，应在 __clone() 中把内部对象也 clone 一次。

meta = clone $this->meta;
    }
}

$origin = new Document('正文', new Meta('原稿'));
$copy = clone $origin;

// 副本修改自己的 Meta，不应影响原对象的 Meta。
$copy->meta->label = '副本';

如果 Meta 还包含数组、集合或其他对象，是否继续向下 clone 取决于它自己的结构。readonly 只负责控制 Document::$meta 这个引用的重新绑定，不会替你设计整个对象图的深拷贝策略。

PHP 8.2 及更早版本怎么处理

在 PHP 8.2 及更早版本，readonly 属性不能在 __clone() 中这样重新初始化。此时不要用反射或引用硬绕过约束，而是把“复制并改变字段”改成显式工厂方法，让新对象通过构造器完成初始化。

title, null);
    }
}

$origin = new LegacyDraft('接口设计草稿', 42);
$copy = $origin->copiedForEdit();

这条回退路径的代价是需要显式列出所有构造参数，但它的语义很清楚：原对象不变，新对象由构造器建立。若字段很多，可以把参数集中到命名工厂或复制构造器，仍然不要把普通 clone 的行为假设带到旧版本。

写 __clone 前的四个判断

1. 版本：目标环境至少是 PHP 8.3；否则改用工厂方法或复制构造器。
2. 字段：只重初始化确实属于副本身份的字段，例如持久化 ID、临时令牌或编辑状态。
3. 对象图：readonly 属性里若有可变对象，明确是否需要对内部对象继续执行 clone。
4. 写入次数：每个 readonly 属性在一次 __clone() 中只安排一次直接写入，不用引用做间接修改。

结论：把副本变化放进 __clone

PHP 8.3 起，readonly 属性在 __clone() 中可以为克隆副本重新初始化一次。最稳妥的实现方式是：先由 clone 复制原对象，再在 __clone() 中直接写入需要变化的字段；遇到对象属性时，再按对象图决定是否深拷贝。PHP 8.2 及更早版本则使用工厂方法，让新对象从构造器获得新状态。

相关问题

readonly 属性在 clone 后一定会自动变成未初始化吗？

不会。普通 clone 先复制原值，只有类定义了 __clone() 并在其中主动写入时，副本字段才会得到新值。

可以在 __clone() 外部修改副本的 readonly 属性吗？

不可以。重初始化窗口属于副本执行 __clone() 的类内部逻辑，外部赋值仍然会触发 readonly 约束。

readonly 对象属性会自动深拷贝吗？

不会。readonly 保护引用不能被普通代码重新绑定，但引用指向的对象仍可能内部可变；需要隔离时，在 __clone() 中显式 clone 该对象。