php 8.5 引入了 clone with 语法，允许在克隆对象的同时通过构造函数参数直接修改特定字段，从而省去手动逐字段赋值的样板代码。具体做法是在 clone 关键字后紧跟一个括号包裹的参数列表，这些参数会传递给目标类的构造函数，而原对象的其余属性保持不变。例如，使用 $newobj = clone $oldobj (field: value) 即可生成一个基于旧对象但指定字段已更新的新实例。
如何定义支持 clone with 的类？
要使类支持 clone with，必须定义一个接受所有可选修改字段的构造函数，并确保未提供的字段能从当前对象状态中获取默认值。这通常意味着构造函数需要接收一个 self 类型的可选参数作为“源对象”，或者利用 PHP 的属性提升（Property Promotion）结合默认值来实现。核心逻辑是：如果提供了新值，则使用新值；否则，从传入的源对象（如果有）或默认值中获取。
<?php
class User {
public function __construct(
public string $name,
public string $email,
public ?string $nickname = null,
) {}
// 支持 clone with 的工厂方法或魔术方法通常由引擎内部处理
// 但为了演示，我们看实际调用方式
}
$original = new User('Alice', 'alice@example.com');
// 使用 clone with 语法修改 nickname
$newUser = clone $original (nickname: 'Ally');
var_dump($newUser->name); // string(5) "Alice"
var_dump($newUser->email); // string(16) "alice@example.com"
var_dump($newUser->nickname); // string(5) "Ally"在上述代码中，User 类使用了属性提升。当执行 clone $original (nickname: 'Ally') 时，PHP 引擎会创建一个临时上下文，将 $original 的属性作为默认值注入，然后应用 (nickname: 'Ally') 中的覆盖值。最终调用构造函数生成新对象。注意，目前 PHP 稳定版本（截至 8.4）尚未正式包含此特性，这是基于 PHP RFC 提案的未来语法，实际使用时需确保运行环境支持或查看最新开发版文档。若在当前生产环境，通常仍建议使用 __clone 方法或静态工厂方法。
立即学习“PHP免费学习笔记（深入）”；
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
clone with 与 __clone 方法的交互是怎样的？
在使用 clone with 语法时，__clone 魔术方法的行为取决于实现细节。通常情况下，clone with 会先完成浅拷贝，然后应用构造函数参数，最后可能触发 __clone。然而，为了简化模型并避免副作用，建议在设计支持 clone with 的类时，尽量保持 __clone 为空或仅处理深层资源复制，而将状态变更逻辑集中在构造函数中。这样，clone with 的参数覆盖能更直观地反映最终状态。
<?php
class Config {
public function __construct(
public array $settings,
public string $version = '1.0',
) {}
public function __clone() {
// 深拷贝 settings 数组，避免引用共享
$this->settings = unserialize(serialize($this->settings));
}
}
$config = new Config(['debug' => false], '1.0');
// 修改 version，同时 settings 会被 __clone 深拷贝
$newConfig = clone $config (version: '2.0');
var_dump($newConfig->version); // string(3) "2.0"
var_dump($newConfig->settings['debug']); // bool(false)在这个例子中，Config 类定义了 __clone 来确保 settings 数组被深拷贝。当使用 clone $config (version: '2.0') 时，PHP 会先复制对象，然后应用 version 的新值，最后调用 __clone 进行深拷贝处理。这种组合既利用了 clone with 的简洁性，又保证了复杂数据的独立性。开发者需注意，__clone 的执行时机可能在参数应用之前或之后，具体行为应参考 PHP 官方文档的最新说明，但在大多数预期场景中，构造函数参数的优先级高于原对象属性，而 __clone 用于后续的资源清理或深拷贝。
clone with 如何处理构造函数中的必填参数？
如果 clone with 尝试修改一个在构造函数中定义为必填且无默认值的参数，而原对象中该参数存在，则通常不会报错，因为原对象的值会被用作默认值。但如果原对象中该参数缺失（例如通过动态添加），则会导致错误。因此，最佳实践是确保所有可能被 clone with 修改的字段在构造函数中都有明确的类型和默认值（可以是来自源对象的占位符）。对于不可变的必填字段，不应出现在 clone with 的参数列表中，除非你希望强制覆盖它。
