PHP 8.5 clone() with 怎么更新 readonly DTO：浅拷贝、嵌套对象与回滚边界

订单服务里经常需要把“已确认订单”转成“待支付订单”：金额、商品明细和收货地址大部分相同，只改状态与过期时间。PHP 8.4 及更早版本通常要写构造器、with 方法或者临时数组中转；PHP 8.5 新增的 clone() with 允许在复制对象时一次性覆盖指定属性，特别适配 readonly DTO 场景，但它本身不是深拷贝，也不会自动替你校验嵌套对象的可变性。

把 clone($order, ['status' => 'pending']) 当成“生成新快照”，不要当成递归复制：顶层属性会按新值替换，嵌套对象仍可能与原对象共享引用。

先看一个订单快照场景为什么需要 clone() with

假设订单对象只允许在初始化阶段写入属性。支付流程收到“已确认”订单后，需要生成一个全新的“待支付”快照，而不是直接修改旧对象。旧写法往往要把所有属性重新传一遍，字段一多就很容易出现漏传的问题。

 'pending',
    'expiresAt' => new DateTimeImmutable('2026-08-16 22:00:00'),
]);

$confirmed 仍然是 confirmed，$pending 只有显式列出的两个属性发生变化。这个写法的价值不是少写几行代码，而是把“状态转换一定会产生新快照”的逻辑直接落地到代码表达层面。

clone() with 到底复制了什么

PHP 8.5 官方说明把它定义为带属性更新的对象克隆。未列出的属性保留复制前的取值，列出的属性在克隆流程完成前写入新生成的对象。它不会遍历整个对象图，也不会把每个成员递归复制一遍。

嵌套对象是浅拷贝，地址对象要单独处理

订单快照如果再包含一个 Address 子对象，直接克隆订单并不会自动复制 Address。于是新快照和旧快照可能指向同一个地址对象，这对审计记录和操作回滚都有潜在风险。

 'pending']);

var_dump($old->address === $new->address); // true
var_dump(spl_object_id($old->address) === spl_object_id($new->address)); // true

本例中 Address 本身是 readonly，内部状态不能被原地修改，共享引用通常是业务可接受的。如果嵌套对象包含可变集合、缓存或者外部句柄，就应该显式构造全新的对象，再把它作为覆盖值传给 clone() with。

版本门禁和兼容工厂怎么安排

clone() with 是 PHP 8.5 新增语法。运行环境仍是 PHP 8.4 的服务器无法解析这段代码，因此不能只在业务分支里做版本判断就直接使用。公共库可以保留一套旧版本兼容工厂，把新语法的实现隔离到 PHP 8.5 专用文件里，部署流水线则在启动阶段检查 PHP_VERSION_ID。

 'pending']);

如果项目必须同时支持 PHP 8.4，应继续使用命名构造器或者显式 with 方法实现，并把两套实现放在不同文件中。不要把 8.5 专属语法写进需要被旧版本加载的公共入口文件里。

上线前用四个检查确认状态转换没有副作用

• 原对象检查：克隆前后的原对象状态、金额、地址数据均保持不变。
• 新对象检查：只允许白名单内的字段发生变化，不在预期内的字段变动要直接在测试中暴露出来。
• 引用检查：对嵌套对象执行 spl_object_id() 或者严格比较，确认共享引用是业务有意为之。
• 版本检查：CI 流程用 PHP 8.5 运行语法测试，兼容分支单独在 PHP 8.4 环境下验证。

常见问题

clone() with 会深拷贝嵌套对象吗？

不会。它的核心逻辑是复制当前对象并覆盖指定属性；嵌套对象的复制仍取决于对象自身的克隆逻辑和你的显式构造处理。

readonly 对象还能修改属性吗？

原对象不能原地修改属性，但 PHP 8.5 可以在 clone() with 的复制阶段为新生成的对象指定属性值。

PHP 8.4 能运行 clone() with 吗？

不能直接运行。它是 PHP 8.5 新增的语法能力，需要版本门禁、条件部署或者旧版本兼容实现。

什么时候不适合使用 clone() with？

当对象包含数据库连接、文件句柄、可变集合或者复杂外部资源时，优先设计明确的工厂或者复制方法，避免把浅拷贝误当成完整快照使用。

把 clone() with 用在不可变 DTO 的状态转换场景上，能减少重复构造参数的冗余代码；真正需要留意的是嵌套引用和部署版本两个点。只要把这两点纳入常规测试流程，PHP 8.5 的新语法就能保持清晰且支持操作回滚。