php8.4readonly属性有什么用_php8.4只读属性应用场景【详解】

作者:雪夜2026-01-01 00:00:00

PHP 8.4 的 readonly 属性行为与 PHP 8.2 一致，仅允许在构造函数中赋值一次，禁止运行时任何写入（含反射、反序列化、__clone/__wakeup），不递归保护嵌套值，提供编译器级不可变保障。

PHP 8.4 的 readonly 属性不是新特性——它早在 PHP 8.2 就已引入，PHP 8.4 并未修改其行为。如果你在 PHP 8.4 环境下遇到 readonly 相关问题，大概率是升级后暴露了旧代码中对只读属性的非法写入，或误用了兼容性边界。

readonly 修饰的类属性，仅允许在构造函数（__construct）中赋值一次，之后任何写入（包括对象自身方法、反射、序列化还原后的赋值）都会抛出 Fatal error: Uncaught Error: Cannot modify readonly property。

✅ 允许：

class User {
    public readonly string $name;
    public function __construct(string $name) {
        $this->name = $name; // 唯一合法赋值点
    }
}

❌ 禁止：$user->name = 'new';、$user->__set('name', ...)、ReflectionProperty::setValue()、反序列化时覆盖该属性（即使 unserialize() 返回的对象含该字段）
⚠️ 注意：只读性不递归——public readonly array $data; 中的 $data['key'] = 'val' 仍合法，因为修改的是数组元素，不是属性本身

PHP 明确禁止在 __clone 和 __wakeup 中给 readonly 属性赋值，哪怕你试图“重置”它。这是设计使然：只读属性代表值在对象生命周期内恒定，克隆/反序列化应产生语义等价的新实例，而非绕过约束。

❌ 错误写法：

public function __clone() {
    $this->id = uniqid(); // Fatal error
}

readonly 解决的是「实例级不可变」，和 const（类级常量）、final class（禁止继承）、__get（模拟只读访问）完全不在同一维度。

const NAME = 'foo'; → 所有实例共享，无法按实例定制
final class → 阻止继承，不影响属性可变性
仅靠 __get + 私有属性 → 只能拦截公共访问，无法阻止内部方法或反射修改
readonly → 编译器级保护，连 ReflectionProperty::setValue() 都被拦截，且 IDE 和静态分析工具（如 PHPStan）能识别并报错

升级到 PHP 8.2+ 后，最常触发 readonly 报错的不是新代码，而是旧逻辑里隐式修改了本该只读的字段。

ORM 映射：Doctrine 或 Laravel Eloquent 若将数据库字段映射为 readonly 属性，但又在 hydrate 过程中尝试赋值（比如从查询结果 set），会直接崩溃
DTO 构造后又被 setter 修改：例如 $dto = new OrderDto(...); $dto->status = 'shipped'; —— 若 status 是 readonly，这里就炸
测试 Mock：用 Mockery 或 PHPUnit 的 setMethods() 尝试 mock 只读属性的 setter，会失败（因为根本不存在可覆盖的 setter）
JSON 序列化/反序列化：用 json_decode($json, true) 再 foreach 赋值到 readonly 属性，必须确保只在 __construct 中做，否则运行时报错