PHP readonly 类继承时有哪些属性限制

PHP 8.2 起可以把整个类声明为 readonly class。继承时最容易踩的规则只有一句：只读父类的子类也必须是只读类。普通子类不能通过 extends 进入这条继承链；同时，子类新增的属性仍要满足只读类对类型、静态属性和动态属性的限制。

可以继承，但必须保持 readonly；可以新增带类型的实例属性，但不能声明无类型属性或静态属性，也不能在运行时临时添加新属性。

readonly 父类能不能被普通子类继承

先把继承关系分成两种看。下面第一条是合法的只读继承，第二条会在类加载阶段失败。示例中的注释说明了每个声明的意图，不能把第二个类当成运行时异常来捕获，因为它属于编译期边界。

因此，项目里如果只读基类下方还有普通 DTO、代理对象或懒加载对象，不能只给父类加修饰符。要么让整条继承链都保持 readonly，要么把共享逻辑提取到接口、组合对象或普通基类中。

子类属性声明的四个边界

readonly class 会把已经声明的属性纳入只读模型，并且阻止动态属性。这里的“只读”不是只限制父类字段，而是限制整个类层次中声明的属性。写迁移代码时，可以按下面四项检查：

特别容易误判的是 #[\AllowDynamicProperties]。它不能为 readonly class 开绿灯，反而会触发编译期错误。静态属性也一样：静态状态不属于某个对象实例，和 readonly 类的实例属性模型不兼容。

从普通继承迁移到只读继承的检查顺序

1. 先查继承链。从被标记为 readonly 的父类向下搜索所有 extends，每个子类都补上 readonly，或改成组合关系。
2. 再查属性声明。确认每个属性都有类型，并删除 static 属性、无类型属性和通过魔术方法隐式创建的字段。
3. 最后查初始化路径。构造函数、命名构造器和反序列化入口都要在对象建立阶段提供值；不要把首次赋值推迟到业务方法。

isReadOnly());

        foreach ($reflection->getProperties() as $property) {
            // 这里关注属性是否带 readonly 修饰，辅助迁移排查。
            var_dump($property->getName(), $property->isReadOnly());
        }
    }
}

ReadonlyCheck::inspect(UserEntity::class);

这段反射代码只用于检查声明，不代表线上业务已经通过测试。真正上线前还要覆盖序列化、依赖注入容器代理和子类构造参数；这些机制如果需要后置写入，就不适合直接放进 readonly 继承链。

常见边界问题

子类能否只把父类的部分属性改成可写？不能。readonly 父类的继承约束不能被子类放宽，子类本身也必须声明 readonly。

readonly class 还能使用方法和常量吗？可以。限制集中在属性和动态属性，不是禁止定义普通方法或类常量；但方法不能通过对象属性写入绕过只读模型。

实际迁移可以记成一张清单：readonly 父类 → readonly 子类 → 带类型实例属性 → 构造阶段初始化 → 反射确认。只要其中出现普通子类、static 属性、无类型属性或运行时补字段，就应先调整设计，再继续升级。