PHP8.2 Readonly属性调用方法详解

PHP 8.2 的 readonly 类与构造器属性提升共同构成了一项严格而不可绕过的初始化契约：所有 promoted 属性必须在构造函数调用时显式、完整赋值，任何遗漏、延迟初始化、DI 容器无参实例化、Mock 工具反射设值或继承时未显式调用父构造等行为，都会在对象创建的瞬间触发致命错误——这不是运行时校验，而是语言层的硬性保障，倒逼开发者在数据组装源头就严守完整性，用工厂函数、显式参数绑定和结构化 fixture 取代侥幸逻辑，让“只读”真正成为可信赖的设计契约而非表面修饰。

PHP 8.2 的 readonly 类配合构造器属性提升（constructor property promotion）不是“调用”出来的，而是**必须通过构造函数显式初始化、且不允许跳过或补赋值**——任何绕过 __construct() 的方式都会立即报错。

new readonly class() 必须传全参数，不能漏、不能空解包

构造器提升的 readonly 类，所有 promoted 属性都算作“类级只读字段”，PHP 8.2 要求它们在构造时**全部被显式赋值**，哪怕类型是 ?string 或 int|null，也得传 null。

• 错误写法：new UserDTO($data['name'])，但 $data 缺 email 字段 → 触发 Fatal error: Uninitialized readonly property
• 错误写法：new UserDTO(...$data)，而 $data 是 ['name' => 'A']（少键）→ 同样崩溃
• 正确写法：确保数组键完整，或显式补 null：new UserDTO($name, $age, $email ?? null)

DI 容器 / app()->make() 直接失败，必须配构造参数或换工厂

Laravel、Symfony 等容器默认尝试无参实例化，或按类型自动注入，这对 readonly 类完全不适用——它连空对象都创建不了。

• app()->make(UserDTO::class) → 立即 Fatal error，因为没传任何参数
• 即使你配置了容器绑定，也必须显式 bind 构造参数，例如 Laravel 中要用 ->with(['name' => 'X', 'age' => 25])
• 更推荐做法：封装一个 userDtoFromRequest() 工厂函数，统一做 array_key_exists 校验 + 默认值填充，再 new

Mockery / PHPUnit mock 只读类会崩溃，别试

Mockery::mock(UserDTO::class) 或 $this->createMock(UserDTO::class) 在 PHP 8.2 下直接 fatal，因为 mock 工具依赖反射创建空对象再设属性，而这被 readonly 类语法层禁止。

• 替代方案：用真实 fixture 数组，走工厂创建 → UserDTOFactory::fromArray(['name' => 'test'])
• 测试中避免直接 new，尤其带可空字段时，容易漏 null 导致测试在 CI 崩溃
• 如果 DTO 层逻辑复杂，考虑把校验和转换逻辑抽到独立 service，只对 service 单元测试，DTO 仅作数据载体

继承 readonly class 必须双 readonly，且子类构造必须调 parent::__construct()

子类想 extend 一个 readonly 类？可以，但有两个硬性条件缺一不可：

• 子类声明也必须带 readonly 关键字，class Child extends Parent 会编译失败
• 子类构造函数里必须显式调用 parent::__construct(...)，否则父类 promoted 属性未初始化 → 运行时报 Uninitialized readonly property
• 别指望“父类只读，子类自动只读”——PHP 不推导，只认字面 readonly

最常被忽略的一点：只读类不是“运行时防护”，它是语言强制的初始化契约。一旦漏掉一个 promoted 参数，或让 DI 容器/测试框架试图绕过构造函数，错误不是发生在业务逻辑里，而是在对象诞生的第一毫秒就炸了——这反而要求你在组装对象的地方更早、更严格地处理数据完整性。

今天关于《PHP8.2 Readonly属性调用方法详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！