PHP设置只读变量属性方法

PHP 8.1 引入的 `readonly` 属性为开发者提供了引擎级、零开销的不可变性保障——它不是靠魔术方法模拟的脆弱防护，而是编译期强制约束：只允许在构造函数中一次性赋值，之后任何写操作（包括反射）都会触发致命错误；它专用于类属性（不支持变量或静态）、要求显式类型声明、天然适配 DTO/VO 等不可变场景，同时与 `const`、`final` 有本质区别，也提醒你：`readonly` 仅保证引用不可变，对象内部状态仍需设计层面守护——想写出真正安全、高效、可静态分析的不可变代码？这才是 PHP 原生给出的正确答案。

PHP 8.1+ 怎么用 readonly 声明只读属性

PHP 本身没有“只读变量”概念，只有“只读属性”（readonly），且仅支持类属性，不能用于普通变量或函数内局部变量。它从 PHP 8.1 开始引入，底层是编译期强制约束，不是靠魔术方法模拟。

常见错误现象：Fatal error: Cannot assign to readonly property —— 这不是警告，是致命错误，一旦在构造函数外写入就崩。

• readonly 只能修饰类属性，语法为 public readonly int $id;
• 必须在构造函数中完成首次赋值，且只能赋一次；之后任何写操作（包括 $obj->prop = ... 或反射）都会报错
• 不支持 static readonly，也不支持 readonly 数组元素或对象属性嵌套（如 $obj->data->name 不受保护）
• 类型必须显式声明，不支持 mixed 或无类型（PHP 8.2+ 允许 readonly ?string，但依然要类型标注）

为什么不能用 __get/__set 模拟 readonly 属性

手动实现 getter/setter 看似灵活，但本质是运行时防护，绕过方式太多：反射、serialize/unserialize、直接改 $this->prop（如果没设为 private）、甚至数组强制转换都能破坏封装。

而 readonly 是引擎级保障，连反射都不能修改（ReflectionProperty::setValue() 会抛 TypeError）。

• __set 无法拦截 $obj->prop = ... 对 public 属性的直接赋值（除非属性设为 private + 魔术方法，但 public readonly 就是为简化而生）
• __get/__set 会带来性能开销，尤其高频访问场景；readonly 零额外成本
• IDE 和静态分析工具（如 PHPStan）能识别 readonly 并提示误写，对魔术方法则基本无感知

readonly 属性在 DTO 和实体类中的典型用法

最适合用在数据传输对象（DTO）、值对象（VO）或不可变实体上，比如 API 返回的用户信息、数据库查询结果封装。

示例：

class UserDto
{
    public function __construct(
        public readonly string $name,
        public readonly int $age,
        public readonly ?string $email = null,
    ) {}
}

• 构造参数自动绑定到 readonly 属性，省去手写赋值语句
• 允许默认值（如 ?string），但注意：默认值不算“首次赋值”，仍需在构造时显式传入或由参数默认值触发
• 不要试图在构造函数体里再赋值：$this->name = $name; 是冗余且易错的（可能覆盖参数绑定）
• 兼容性注意：PHP 8.0 及更早版本完全不识别 readonly 关键字，会解析失败

readonly 和 const、final 的区别与误用场景

const 是类常量，属于类而非实例，所有实例共享；final 修饰类或方法，跟属性可变性无关；readonly 是每个实例独立持有的、初始化后不可变的属性。

• 别用 const 存实例数据：比如 const CREATED_AT = time(); 会报错，因为 const 必须是编译期常量
• final class 不影响内部属性是否可写，和 readonly 无关
• 误以为 private $x; final public function getX() { return $this->x; } 就安全了——其实 $x 本身仍可被反射或序列化篡改
• PHP 8.2+ 支持 readonly class，表示整个类所有属性都隐式 readonly，但目前仅限于没有构造函数的纯数据类（仍有诸多限制）

真正难处理的是嵌套可变性：一个 readonly 对象属性，其内部字段仍可被修改。比如 public readonly DateTime $createdAt;，你不能改 $dto->createdAt，但可以调 $dto->createdAt->modify('+1 day') —— 这种得靠设计约束或文档约定，语言层管不到。

理论要掌握，实操不能落！以上关于《PHP设置只读变量属性方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！