怎样阅读PHP8.3.5源码的克隆语法-php教程-PHP中文网

php 8.3.5 没有新增“克隆语法”，clone 关键字及 __clone() 机制保持不变；主要改进是增强 readonly 属性在克隆中的语义一致性与错误提示。

怎样阅读php8.3.5源码的克隆语法

PHP 8.3.5 没有“克隆语法” 这一语言特性。所谓“克隆”，在 PHP 中仅指对象复制行为，由 clone 关键字触发，其底层逻辑由 __clone() 魔术方法控制——它不是新语法，也不是 PHP 8.3.5 引入的变更。

你可能混淆了以下几种情况：

把 #[\Override] 属性 误认为是“克隆相关语法”（实际用于方法覆盖校验）；
把 只读属性（readonly）的深拷贝支持 误解为新增克隆语法（PHP 8.3 确实增强了 readonly 类型在序列化/克隆场景下的行为，但仍是原有 clone 机制的扩展，非新语法）；
或看到某些框架/库中自定义的 ->clone()、->duplicate() 等链式方法，误以为是语言级语法（实为普通方法调用）。

H3：`clone` 关键字本身没变，但 `__clone()` 行为有细节调整

PHP 8.3.5 沿用自 PHP 5 的 clone 语义：

$obj = new MyClass();
$copy = clone $obj; // 触发 $obj->__clone()（如果定义）

关键点：

clone 是保留关键字，语法无变化；
__clone() 方法仍必须是 public，否则报致命错误；
PHP 8.3.5 对 readonly 属性做了兼容性增强：当类含 readonly 属性时，clone 不再静默失败，而是更明确地处理不可变性约束（例如禁止修改 readonly 属性的副本）；
Error 和 Exception 的 __clone() 在 PHP 8.1+ 已取消 final 修饰，但 PHP 8.3.5 未进一步修改该行为——它们依然不可被克隆，尝试 clone new Error() 会直接抛出 Error: Cannot clone object of class Error。

H3：想看源码？重点看这三个位置

要真正理解 clone 在 PHP 8.3.5 中如何工作，可查阅 php-src 源码中的以下部分（基于 PHP 8.3.5 tag）：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

Zend/zend_objects.c：核心克隆逻辑，zend_objects_clone_obj() 函数负责分配新对象、复制属性、调用 __clone()；
Zend/zend_object_handlers.c：定义默认对象处理器，其中 std_object_handlers.clone_obj 指向上述函数；
ext/core/core.c：__clone 魔术方法注册逻辑，确保用户定义的 __clone() 被正确识别和调用。

✅ 提示：搜索关键词 ZEND_VM_HANDLER(109, ZEND_CLONE, TMPVAR|CV, ANY) 可定位到虚拟机中 clone 指令的执行入口。

H3：只读属性与克隆的关系（PHP 8.3 实际新增点）

PHP 8.3 加强了 readonly 属性在克隆过程中的语义一致性：

若类含 public readonly string $name;，则 clone 后副本的 $name 仍为 readonly，且值相同；
不允许在 __clone() 中重新赋值 readonly 属性（会报 Error: Cannot modify readonly property）；
这属于类型系统与对象模型的协同优化，不是语法糖，也不需要新写法。

示例：

class User {
    public function __construct(public readonly string $id) {}
    public function __clone() {
        // $this->id = 'new-id'; // ❌ Fatal error — 不允许
    }
}
$u = new User('abc');
$v = clone $u; // ✅ 成功，$v->id === 'abc' 且仍为 readonly

H3：常见误解澄清

没有 clone $a as $b 或 clone(...) 函数式语法：PHP 不支持类似 JavaScript 的结构克隆或 Python 的 copy.deepcopy() 语法；
clone 不等于浅拷贝/深拷贝开关：它默认是浅拷贝；深拷贝需手动在 __clone() 中递归 clone 子对象；
#[\Override] 和 clone 完全无关：前者检查方法覆盖，后者处理对象复制，二者在源码中位于不同模块（Zend/zend_inheritance.c vs Zend/zend_objects.c）。