PHP readonly 属性初始化后为何不能重新赋值

PHP 的 readonly 属性只能完成一次初始化，不能理解成“以后可以随便写，只是提醒调用方少写一点”。构造对象时在声明作用域内完成第一次直接赋值是合法的；对象已经拿到值后再次赋值，即使新旧值完全相同，也会触发 Cannot modify readonly property。

记住一条规则：readonly 锁住的是属性槽位的再次写入和重新绑定，不是把属性指向的对象冻结成不可变对象。

先区分读取、首次初始化和重新赋值

下面的属性没有默认值，构造方法是它的初始化位置。构造完成后，外部代码可以读取 id，但不能再写入。

value = $value;
    }
}

$id = new UserId('u-1001');
echo $id->value;       // 合法：读取已经初始化的值
$id->value = 'u-1002'; // 非法：初始化完成后再次写入
?>

因此，报错并不是因为构造方法没有执行，而是因为构造方法已经执行过一次写入。readonly 属性的语义重点是“初始化后不再修改”，不是“只有外部不可见”。

确认初始化作用域和类型限制

readonly 属性必须有类型，且第一次写入也要发生在允许初始化它的作用域内。把首次赋值放到全局作用域，并不会因为它是“第一次”就被允许。

name = 'production';
?>

实际设计时，通常把构造参数直接交给构造方法，或者由类内部的命名构造方法统一校验后赋值。不要给 readonly 属性写普通默认值；它一旦带默认值，就失去了“对象创建时确定”的设计意义。

排查看不见的间接修改

readonly 阻止的不只是形如 $object->prop = $value 的语句。自增、数组元素修改、unset、引用和按引用传参，都会被视为对属性的间接修改。

count++;
$basket->items[] = 'pen';
unset($basket->items[0]);
?>

排错时如果没有看到第二次显式赋值，应继续搜索这些“语法上不同、语义上仍是修改”的路径。尤其是把属性传给需要引用参数的函数，不能用引用绕过 readonly 边界。

区分属性不可重绑与对象内部可变

readonly 约束的是属性保存的那个引用或值不能被换掉。若属性保存的是对象，对象自身的字段仍可能变化；这叫内部可变性，不等于 readonly 失效。

data->theme = 'dark';

// 非法：试图让 readonly 属性改为指向另一个对象。
$profile->data = new stdClass();
?>

如果业务要求连对象内部状态也不能改变，就不要只依赖 readonly，还应使用不可变值对象、私有状态或只返回新对象的方法。readonly 更适合表达 DTO 的字段不应被重新绑定，而不是自动提供深度不可变。

按 PHP 版本选择构造和克隆策略

readonly 属性自 PHP 8.1 提供。PHP 8.3 起，类可以在 __clone() 中为克隆出来的对象重新初始化 readonly 属性，这个例外只服务于克隆过程，不代表原对象可以随时重新赋值。

token = null;
    }
}
?>

如果项目还运行在 PHP 8.1 或 8.2，不要把克隆重初始化当作通用方案；可以改为显式复制方法或新的构造调用。升级到 PHP 8.4 时，还要留意 readonly 属性默认的设置范围变化，以及继承关系中不能把可写属性和 readonly 属性互相覆盖。

最后检查三个问题即可定位大多数报错：这是不是第二次写入？写入是否发生在声明作用域内？代码修改的是属性槽位，还是属性指向对象的内部字段？答案分别对应重新赋值、非法初始化和内部可变性，修复方向也就不会混在一起。

相关问答

为什么给 readonly 属性赋相同的值也报错？ 因为判断的是是否发生再次写入，而不是比较新旧值是否相等。

readonly 能代替深度不可变对象吗？ 不能。它限制属性槽位，不能自动冻结对象内部字段。

没有默认值是不是漏写了？ 通常不是。readonly 属性正是通过对象创建时的一次初始化来确定值，是否允许未初始化要结合构造路径设计。