PHP 8.2 readonly 类为什么适合值对象：构造边界、复制语义与反例

订单服务里有一类数据只应该被创建一次：收货地址快照、币种金额、税率组合。PHP 8.2 的 readonly class 很适合把这类对象的写入边界收紧到构造阶段，但它只保证属性不能被重新赋值，并不自动把对象内部的所有状态冻结。

把 readonly 类当成“外层引用不可替换”的值对象工具，构造校验、对象内部可变性和 clone 语义仍要分别设计。

先把 readonly class 放在值对象边界上

值对象的关键不是“所有代码都不能改”，而是同一个实例一旦交给订单、日志或缓存层，就不再允许调用方偷偷替换字段。下面的 Address 只保存订单创建时的地址快照，构造函数负责最小校验，Order 只接收已经成立的地址对象。

address->city;
// $order->address = new Address(...); // Cannot modify readonly property
?>

这里的调用链很短：Address 先完成字段校验，随后 Order 保存它；调用方能读取 city，却不能把 address 换成另一个实例。字段必须有类型，readonly 类也不能声明静态属性或依赖动态属性。

真正的边界是引用，不是深度冻结

上面的 Address 只包含字符串，边界足够清晰。如果 readonly 属性换成一个普通对象，外层属性依然不能被替换，但那个对象的内部字段可能继续变化。这个差异在购物车快照、配置对象和 DTO 复用时特别容易被忽略。

contact->phone = '13900000000'; // 外层 readonly，不阻止内部对象变化
?>

因此，值对象字段优先使用字符串、整数、枚举或另一个同样受约束的值对象；如果必须保存可变对象，就把它转换成快照，或者在构造函数中复制必要数据。不要因为类名里有 readonly，就把它当作序列化后的不可变文档。

clone 要先回答“复制什么”

PHP 8.3 起，readonly 属性可以在 __clone() 中重新初始化，这给需要派生快照的场景留下了入口。但普通的 clone 仍然是浅复制：Order 的 address 引用不会自动变成一份全新的地址对象。

如果业务只是把同一份地址快照交给另一个订单，浅复制没有问题；如果要修改城市或详细地址，就应该显式创建新的 Address，而不是尝试修改旧实例。这个决定比“能不能 clone”更重要。

address->province,
    '宁波市',
    $order->address->detail,
);
$nextOrder = new Order('ORD-20260829-002', $nextAddress);
?>

这样做把复制意图写在代码里：新订单拥有新的 Address，旧订单仍保持原快照。若使用自定义 __clone()，还要在 PHP 版本矩阵中单独验证 readonly 字段的重初始化规则。

哪些场景不该套 readonly class

需要逐字段延迟填充的实体、依赖懒加载代理的 ORM 对象、或者本来就要持续变更的聚合根，都不适合直接改成 readonly class。把可变生命周期硬塞进构造函数，往往只是把业务状态藏进外部数组或可变引用，反而让调试更难。

落地时可以按三个问题判断：对象是否在构造后就应保持同一语义？字段能否在构造阶段完成校验？字段中的引用是否也满足快照要求？三个答案都为“是”时，readonly class 才是自然选择。

用最小检查确认边界

isReadOnly()); // bool(true)
var_dump($order->address->city);      // string(9) "杭州市"
?>

上线前至少检查构造失败、重复赋值、外部对象内部变更和复制后的身份差异。反射检查只能确认类声明是 readonly，不能替你证明属性引用的对象没有内部可变状态。

相关问题

readonly class 能声明无类型属性吗？

不能。readonly 属性必须有类型，因此值对象需要先明确字段类型；静态属性也不在 readonly class 的适用范围内。

readonly class 是否等于深拷贝？

不是。它约束的是声明的实例属性，属性中引用的对象仍可能发生内部变化；需要独立快照时要显式创建嵌套值对象。

PHP 8.2 可以在 clone 中重置 readonly 属性吗？

readonly 属性在 PHP 8.3 起支持在 __clone() 中重新初始化。若项目仍运行 PHP 8.2，应按 8.2 的行为设计并在目标版本上验证。

总结

readonly class 的价值在于把值对象的写入权集中到构造阶段，让订单快照、地址和金额这类数据更容易审查。它不是深度不可变标记，也不是复制策略；把构造校验、引用可变性和 clone 语义拆开处理，才能得到稳定的对象边界。