PHP clone with 如何更新 readonly 对象的部分属性

PHP 里搜索“clone with”时，最容易踩的坑是把早期 RFC 示例当成了最终语法。PHP 8.5 的可用写法是 clone($object, ['属性' => 新值])：它先复制对象，再在克隆对象上更新指定属性，原对象不会被改写。这个能力特别适合 readonly 值对象的 withStatus()、withName() 方法。

官方资料：https://www.php.net/releases/8.5/en.php

先分清 PHP 8.5 的 clone() 写法与旧版限制

“clone with”是这项能力的常用称呼，但最终落地的语法是带数组参数的 clone()。普通 clone $object 仍然保留；第二个参数才表示要在新对象上覆盖的属性。PHP 8.4 及更早版本没有这个第二参数，直接给克隆对象的 readonly 字段赋值会报错。

 'paid', // 只更新新对象的 status
]);

// PHP 8.4 及更早版本没有这个写法，不能这样改已初始化的 readonly 属性。
// $next = clone $current;
// $next->status = 'paid';

因此，项目升级前先看运行时版本，再决定文章里的实现是否可以直接落地。不要只因为编辑器能识别 RFC 页面，就把新语法放进仍运行 PHP 8.4 的生产容器。

在类内部用 clone() 更新指定 readonly 属性

最小实现是把变更封装在对象自己的方法里。这样调用者只提供业务值，原对象继续保持不可变；克隆后的对象则拥有新的字段值。类内部调用还处于属性允许写入的作用域，因此适合实现 with-er 风格的方法。

 $status,
        ]);
    }

    public function retry(): self
    {
        // 多字段更新仍只影响返回的新对象。
        return clone($this, [
            'status' => 'retrying',
            'attempts' => $this->attempts + 1,
        ]);
    }
}

// 原对象仍是 pending，next 才是 retrying。
$next = (new OrderState('pending', 0))->retry();

数组键必须是属性名，值必须满足该属性的类型。多个字段按数组的迭代顺序赋值；如果前面的字段钩子或类型检查失败，后面的字段不会继续完成。因此不要把互相依赖的更新拆成无法独立成立的组合。

按作用域、类型和校验规则选择可更新字段

clone() 暂时允许克隆阶段重新设置 readonly，并不意味着它可以从任意位置修改对象内部状态。public readonly 属性默认仍有受限的写入作用域：类外直接调用时，可能得到“Cannot modify protected(set) readonly property”错误；private 或 protected 字段也要回到声明它们的相应作用域中更新。

可以用下面的清单做判断：

如果对象依赖更复杂的业务不变量，优先在属性 set hook 或类内 with 方法中集中校验；不要为了少写几行代码，让 clone() 生成一个构造函数曾经禁止的状态。

PHP 8.4 及更早版本用构造函数完成兼容

旧版本没有 clone() 的属性覆盖参数，推荐继续使用“读取旧值、替换少数字段、重新构造”的方式。它代码稍长，却能让构造函数继续成为校验入口，也不会误用普通 clone 去修改已初始化的 readonly 属性。

attempts);
    }
}

如果字段很多，可以在类内部整理成数组后展开传给 new self(...$values)，但要明确处理私有字段、默认值和构造参数顺序。跨多个 PHP 版本发布时，兼容实现往往比强行依赖 8.5 更稳。

用一张决策表收束实现选择

相关问题

“clone with”到底要不要写 with 关键字？

不要。PHP 8.5 的正式写法是 clone($object, ['field' => $value])；“clone with”只是功能名称和搜索称呼。

clone() 会修改原对象吗？

不会。更新数组作用在新建的克隆对象上，原对象仍保持原字段值。

为什么 public readonly 在类外仍可能失败？

readonly 默认限制写入作用域。需要改变它时，把动作封装到类内方法，或明确设计允许外部 set 的属性可见性。

PHP 8.4 项目能否只改一行升级？

不能只改语法。先确认运行时、容器镜像、CI 和生产环境都达到 PHP 8.5，再替换 with 方法并回归属性校验。