php 8.2 的 readonly 类配合构造器属性提升要求所有 promoted 属性必须在构造时显式赋值,不可跳过、不可延迟初始化,否则立即报 fatal error;di 容器、mock 工具、继承等场景均需严格遵循该契约。

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 容器/测试框架试图绕过构造函数,错误不是发生在业务逻辑里,而是在对象诞生的第一毫秒就炸了——这反而要求你在组装对象的地方更早、更严格地处理数据完整性。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











