PHP 8.5 clone with怎样复制对象并替换少量属性

问题通常出现在一个看起来很合理的值对象里：原对象应该保持不变，但业务只想把 timeoutMs 或 status 换成新值。PHP 8.4 及更早版本往往只能重新收集构造参数再 new 一个对象；PHP 8.5 可以直接使用 clone($object, ['属性' => 新值])，只覆盖列出的属性，其他属性沿用克隆结果。

官方地址：https://www.php.net/oop5.cloning

问题现场：readonly 对象只想改一个字段

假设接口请求参数是不可变对象，调用方希望从 5 秒超时复制出一个 10 秒版本。若每次都手写 new RequestOptions(...)，构造函数新增参数时，所有 withTimeout() 方法都可能跟着修改；如果类里还有私有状态或派生字段，重新组装也容易漏字段。

 $timeoutMs]);
    }
}

$normal = new RequestOptions('/orders', 5000, true);
$slow = $normal->withTimeout(10000);

// 原对象与副本只有目标属性不同
var_dump($normal->timeoutMs, $slow->timeoutMs);

这里真正要排查的不是“能不能复制对象”，而是“复制后要改的字段是否明确”。如果目标只是少量属性，clone() 能把变化集中在调用点；如果需要重新计算很多字段，仍然应该保留一个有明确不变量的工厂或构造方法。

初步判断：先区分旧式 clone 和 PHP 8.5 clone()

旧语法 clone $object 仍然有效，它只负责生成对象副本；PHP 8.5 又允许把 clone 写成函数调用形式，并传入第二个数组参数。两种形式不要混为一谈：

因此，出现“readonly 属性不能再次赋值”的旧代码时，不要把原对象强行解锁，也不要把所有字段暴露成可写属性。应先确认部署运行时是 PHP 8.5，再把变化写进类自己的 with... 方法。

动手验证：只列出需要改变的属性

最小验证只关注三个结果：原对象的值没有变化，副本的目标字段变成新值，副本中未列出的字段仍与原对象一致。第二个参数使用属性名作为键，值的类型仍由属性声明和常规赋值规则约束。

 $status]);
    }
}

$before = new OrderSnapshot(42, 'pending', 3);
$after = $before->withStatus('paid');

// 预期：pending / paid / 42 / 3
printf("%s / %s / %d / %d\n", $before->status, $after->status, $after->id, $after->version);

如果把 ['status' => 'paid'] 写成没有键的数字数组，表达的就不再是“覆盖 status”，而是给对象增加数字键属性，结果既不清晰，也可能触发动态属性相关提示。对业务对象始终使用具名键。

定位原因：__clone() 和属性覆盖谁先发生

排查复杂对象时最容易忽略的是顺序。PHP 官方文档说明，__clone() 会先运行，之后才应用第二个参数中的属性覆盖。这样设计保留了原有克隆钩子的语义，但也意味着 __clone() 内部看到的仍是克隆阶段的旧值。

filters = array_values($this->filters);

        // 这里基于克隆时的 filters 生成默认 key
        $this->cacheKey = 'report:' . count($this->filters);
    }

    public function withFilters(array $filters): static
    {
        // filters 的覆盖发生在 __clone() 之后；不要在 __clone() 中依赖新 filters
        return clone($this, ['filters' => array_values($filters)]);
    }
}

$copy = (new ReportOptions(['paid'], 'old'))->withFilters(['paid', 'refunded']);

因此，覆盖属性之后需要同步计算的派生值，不能只放进 __clone()。可以把同步逻辑放进 withFilters()，或者让派生值在读取时计算；不要假设 __clone() 会收到第二个数组参数。

修复方案：把 with 方法和兼容边界写清楚

如果属性是 private 或 protected，最稳妥的入口仍是类内部的方法，由类自己决定哪些字段允许被替换。对外直接传入未知属性名不会自动变成“安全更新”；属性不存在、类型不匹配或属性钩子拒绝赋值时，仍会按常规规则产生错误。

同时要留意运行时版本。clone($object, $overrides) 是 PHP 8.5 的能力，不能把它直接下发到仍运行 PHP 8.4 的节点。跨版本库可以保留构造函数重建的实现，或在升级完成后再切换调用点；不要用字符串拼接或动态执行来规避语法差异。

 $backoffMs]);
    }
}

验证结果：用三项复查结束排查

把代码放进 PHP 8.5 运行时后，按下面三项复查即可判断这次改造是否达到预期：

• 原对象不变：调用 with... 前后，原对象的目标属性和其他属性都没有被改写。
• 副本只变一处：副本中的覆盖字段是新值，未列出的字段仍从原对象复制；可变成员是否需要深拷贝由 __clone() 负责。
• 版本明确：所有执行该代码的节点都确认是 PHP 8.5；旧版本分支仍使用构造函数重建。

常见问题

clone with 会修改原对象吗？

不会。它先生成副本，再把第二个参数中的值应用到副本。原对象仍保持原属性值。

__clone() 能拿到我传入的覆盖数组吗？

不能直接拿到。按照 PHP 8.5 的语义，__clone() 先执行，属性覆盖随后发生；需要基于新值计算派生状态时，应把逻辑放在 with... 方法或其他显式方法中。

PHP 8.4 能运行 clone($object, $values) 吗？

不能把第二个属性覆盖参数当作跨版本语法使用。旧版本应继续用普通 clone 或构造函数重建，并在运行时升级到 PHP 8.5 后再采用 clone-with。