PHP readonly 属性赋值失败时怎么判断初始化位置

给 DTO 加上 readonly 后，最容易误判的是“赋值失败”只有一种原因。实际上，PHP 会把未初始化、初始化作用域不允许、初始化后再次修改、通过引用间接修改分成不同错误。先记住一句话：readonly 属性必须在允许的作用域内直接写入一次；写入完成后，连相同的值也不能再赋。

官方文档：https://www.php.net/manual/en/language.oop5.properties.php

先把 readonly 的“初始化”定义清楚

它不是“构造函数结束前可以随便改”的临时变量，而是一次性写入的公开只读契约。属性必须有类型，例如 public readonly string $email;；不能通过默认值提前完成初始化，也不能声明为静态属性。

版本差异也要留意：PHP 8.1 到 8.3，普通 readonly 属性只能由声明它的类写入；PHP 8.4 起默认写入范围变为 protected(set)，因此子类可以完成尚未初始化属性的写入。但这不会让已经有值的属性重新赋值。

构造函数能写，对象外部为什么不能写

下面的 email 在构造函数中由声明类直接赋值，因此对象创建成功；构造完成后再从调用方写入，即使值完全相同，也属于修改。

email = $email;
    }

    public function replaceEmail(string $email): void
    {
        // 这里不是“再次初始化”，而是尝试修改已有值，会抛出 Error。
        $this->email = $email;
    }
}

$profile = new UserProfile('dev@example.test');
// 外部写入不属于声明类作用域：不能初始化 readonly 属性。
$profile->email = 'new@example.test';

如果错误是 Cannot initialize readonly property ... from global scope，重点看“第一次写入发生在哪里”；如果是 Cannot modify readonly property，重点看此前是否已有构造函数、工厂方法或反序列化路径写过该属性。

四类报错对应四个排查方向

特别容易漏掉的是数组属性。$this->tags[] = 'php' 不是读取后再写回，而是对 readonly 数组做间接修改，同样会失败。对象属性则有“内部可变”例外：readonly 保存的对象不能被替换，但对象自身的字段仍可能变化。

用反射判断：现在到底有没有初始化

不要只靠 isset() 猜状态。需要排查 DTO、hydrator 或复杂构造分支时，可以直接查询反射状态；isInitialized() 返回 false，就说明当前对象的属性还没有值。

isInitialized($data)); // false

// 真正的初始化仍应交给声明类的构造或受控工厂，不要把反射当成业务 setter。

修复时把首次赋值集中到构造函数或明确的工厂入口，并删除后续 setter；如果必须支持 PHP 8.1—8.3，子类不能承担首次写入，应该让父类构造函数接收值。PHP 8.4 项目则仍要保留这条设计约束，避免把“子类可初始化”误解为“子类可修改”。

相关问题

readonly 属性可以声明默认值吗？

不可以。默认值会让它更像类常量，PHP 会在声明阶段拒绝。

同一个值再赋一次也会失败吗？

会。判断标准是是否已经初始化，不是新旧值是否相同。

readonly 数组能不能追加元素？

不能。追加、删除、修改元素都属于间接修改；需要变化时应创建新对象或使用非 readonly 的内部状态。

PHP 8.4 子类能否给 readonly 属性赋值？

对尚未初始化的属性，默认情况下可以；对已经初始化的属性仍然不能重新赋值。

排查这类错误时，先沿着错误文本判断“第一次写入、第二次写入、间接写入还是提前读取”，再回到具体调用栈定位初始化入口，通常比盲目删除 readonly 更快。