PHP readonly class 怎样限制属性修改

PHP readonly class 会让类中声明的所有属性自动采用只读约束：在普通对象使用中，属性初始化后不能再次赋值、直接修改数组元素或被删除。它也禁止动态属性，但不代表对象内部引用的其他对象都被冻结，更不等于禁止继承。

只读类从 PHP 8.2.0 起提供。官方类声明说明：https://www.php.net/manual/en/language.oop5.basic.php；属性语义：https://www.php.net/manual/en/language.oop5.properties.php。本文示例以 PHP 8.2及以上的普通初始化与使用为范围，不把后续版本的克隆特例解释成任意位置可重写。

先声明一个只读的数据载体

假设需要把访问记录交给展示层，展示层可以读取编号与标签，却不应覆盖它们。最小写法是把 readonly 放在 class 前，并在构造函数内初始化有类型的属性。以下代码是独立示例，未在本文环境中运行。

code = $code;
        $this->labels = $labels;
    }
}

AccessNote 是只读类，code 与 labels 是它声明的属性，构造函数负责初始化；读取方可以访问 public 属性，却不能把 public 理解为“初始化后仍可写”。属性类型也不是可选装饰：只读类不能声明无类型属性，不能声明静态属性。需要容纳不同类型时，应明确选择合适的类型，而不是省略类型。

若现有类只有少数属性需要固定，可考虑单独声明只读属性，不必把整个类转成 readonly。类级声明更适合所有实例属性都遵循同一种约束的数据载体。

哪些修改会被拒绝，哪些不会

先区分“属性保存的值”与“被引用对象的内部状态”。字符串属性初始化后不能重写；数组属性也不能直接追加或改元素。若属性保存的是一个可变对象，调用该对象自身的方法改变内部状态，并没有替换属性保存的对象，所以仍可能成功。

后面的 SnapshotCard 示例故意使用 DateTime：createdAt 属性保存一个 DateTime 对象，外部变量 clock 也访问同一个对象；modify 改变的是它的内部日期。readonly 约束 createdAt 的重新赋值，不负责冻结 DateTime。title 与 labels 则分别展示标量重写和数组追加被拒绝的边界。

需要更接近不可变值对象时，建议优先选择不可变的成员类型，并控制其他可变成员的暴露方式。仅给外层类添加 readonly，不能据此承诺整个对象图深度不可变。

继承时必须保持只读约束

readonly 与 final 解决不同问题：前者约束属性，后者限制类被继承。只读类可以被扩展，但子类也必须声明 readonly；同样不能通过只读子类把普通父类整体改造成只读继承链。下面展示合法的父子关系，不包含会阻断编译的非法类定义。

父类构造函数参数提升声明 number 属性，子类未覆盖构造函数，因此沿用父类初始化。不要把“子类也只读”误解成属性初始化作用域在所有版本都相同：PHP 8.4 起只读属性隐含 protected(set)，此前是 private-set。跨版本库若依赖子类初始化继承属性，应按最低支持版本设计；本例由父类构造函数初始化，避免依赖这个差异。

普通继承规则参考：https://www.php.net/manual/en/language.oop5.inheritance.php。若根本不希望数据载体被扩展，可像下节一样组合 final readonly，而不是依赖 readonly 达到禁止继承的效果。

把边界写进可复制的完整示例

下面代码可保存为一个独立 PHP 文件阅读或自行试用，不依赖前两个示例。它用 Error 捕获两次被拒绝的修改，随后展示共享可变对象。所有期望均按语言规则推导，没有在本文实际执行。

title = $title;
        $this->labels = $labels;
        // 这里有意保留传入对象，演示对象内部仍可变，不是深度不可变方案。
        $this->createdAt = $createdAt;
    }
}

$clock = new DateTime('2026-01-15 09:00:00', new DateTimeZone('UTC'));
$card = new SnapshotCard('draft', ['internal'], $clock);

try {
    // 初始化后重新赋值，即使写入相同值也会触发 Error。
    $card->title = 'draft';
} catch (Error $error) {
    echo 'title: blocked', PHP_EOL;
}

try {
    // 数组元素的直接追加同样属于修改只读属性。
    $card->labels[] = 'external';
} catch (Error $error) {
    echo 'labels: blocked', PHP_EOL;
}

// 没有替换属性保存的对象；只是修改同一个 DateTime 的内部状态。
$card->createdAt->modify('+1 day');
echo $card->createdAt->format('Y-m-d'), PHP_EOL;
echo $clock->format('Y-m-d'), PHP_EOL;

按示例规则，前两行应分别显示 title: blocked 与 labels: blocked；随后两次日期读取都应是2026-01-16，因为 card 与 clock 使用同一个 DateTime。这不意味着只读字段已经可以重新赋值。

可以用 AllowDynamicProperties 恢复动态属性吗？

不能。官方类声明说明明确禁止对只读类用该属性恢复动态属性支持。应先声明所需的类型属性，或者选择不同的数据模型。

方法还可以正常定义吗？

可以。readonly 不是“类只能装数据”的语法，也不禁止方法读取属性或返回计算结果；方法仍要遵守同样的属性修改约束。

克隆后是否永远不能重新初始化？

不能作这种跨版本断言。官方属性文档说明 PHP 8.3 起在 __clone 中存在只读属性重新初始化的特例；本文没有实现克隆逻辑，不能把这个特例推广为原对象可随意重写。需要克隆变体时应另行按目标版本设计。

选择 readonly class 的关键是明确“整个类的属性都应该遵守只读约束”。它简化声明，却不替代成员对象的可变性设计，也不替代 final 和继承兼容分析。