php 8.1引入的`readonly`关键字旨在简化不可变对象的创建，确保属性在初始化后不会被意外修改，从而提升代码的健壮性和可预测性。本文将深入探讨`readonly`属性的用途、与传统方法的对比、与常量之间的区别，并展示其在php 8.1和8.2中的应用，帮助开发者高效构建不可变数据结构。
1. readonly 属性的引入与核心价值
在软件开发中，不可变对象（Immutable Objects）因其数据状态的稳定性和可预测性而备受青睐。它们一旦创建，其内部状态便无法改变，这有助于减少副作用、简化并发编程、提高代码的可靠性。然而，在PHP中实现真正的不可变性往往需要编写大量的样板代码。
PHP 8.1引入的readonly关键字，正是为了解决这一痛点，它允许开发者声明不可变的类属性。其核心价值在于：
- 数据完整性：确保属性值在对象生命周期内不会被意外修改，从而维护数据的一致性。
- 代码可预测性：由于属性值不会改变，开发者可以更自信地推断代码行为，减少调试难度。
- 简化开发：减少了手动实现不可变性所需的样板代码，提高了开发效率。
2. 构建不可变对象的传统方式
在readonly关键字出现之前，PHP开发者通常通过以下方式实现属性的不可变性：将属性声明为private，并通过一个公共的“getter”方法提供只读访问。这种方法虽然有效，但会引入大量的冗余代码。
以下是一个传统实现不可变属性的示例：
立即学习“PHP免费学习笔记（深入）”；
class Foo
{
private DateTimeImmutable $createdAt;
public function __construct()
{
$this->createdAt = new DateTimeImmutable();
}
public function getCreatedAt(): DateTimeImmutable
{
return $this->createdAt;
}
}
$f = new Foo();
echo $f->getCreatedAt()->format('Y-m-d H:i:s');
// 尝试修改 $f->createdAt 会导致错误，因为它是一个私有属性
// $f->createdAt = new DateTimeImmutable(); // 错误这种方法要求为每个需要不可变的属性编写私有声明、构造函数初始化以及公共getter方法，当类中存在多个此类属性时，代码会显得臃肿。
3. PHP 8.1 readonly 属性的优雅实现
PHP 8.1通过引入readonly关键字，极大地简化了不可变属性的定义。只需在属性声明前加上readonly，即可使其在初始化后不可修改。属性的初始化只能在声明时或类的构造函数中进行。
结合PHP 8.0引入的构造器属性提升（Constructor Property Promotion），readonly属性的定义变得更加简洁：
class Foo
{
public function __construct(
public readonly DateTimeImmutable $createdAt = new DateTimeImmutable()
) {
// createdAt 属性在这里被初始化
}
}
$f = new Foo();
echo $f->createdAt->format('Y-m-d H:i:s');
// 尝试修改 readonly 属性会导致错误
// $f->createdAt = new DateTimeImmutable(); // Fatal error: Readonly property Foo::$createdAt cannot be reinitialized在这个例子中，createdAt属性被声明为public readonly，这意味着它可以被公开访问，但一旦在构造函数中被赋值，就不能再被修改。这在保持了可访问性的同时，也强制了其不可变性，大大减少了样板代码。
4. PHP 8.2 readonly 类的进一步强化
PHP 8.2在此基础上更进一步，引入了readonly类。当一个类被声明为readonly时，该类的所有属性都将自动变为readonly，无需逐一标记。这对于需要整个对象都不可变的情况提供了极大的便利。
readonly class UserProfile
{
public function __construct(
public string $name,
public DateTimeImmutable $createdAt = new DateTimeImmutable()
) {
// name 和 createdAt 属性在这里被初始化
}
}
$user = new UserProfile(name: 'John Doe');
echo $user->name . ' created at ' . $user->createdAt->format('Y-m-d H:i:s');
// 尝试修改任何属性都会导致错误
// $user->name = 'Jane Doe'; // Fatal error: Readonly property UserProfile::$name cannot be reinitialized通过将UserProfile类声明为readonly，其内部的$name和$createdAt属性都自动获得了readonly的特性，确保了UserProfile对象的整体不可变性。
5. readonly 属性与常量的异同
readonly属性与类常量（const）都提供了某种形式的不可变性，但它们之间存在关键差异：
| 特性 | readonly 属性 | 类常量 (const) |
|---|---|---|
| 初始化时机 | 运行时，通常在对象实例化（构造函数）时赋值一次。 | 编译时定义，其值在代码加载时确定。 |
| 值 | 绑定到特定对象实例，不同实例可以有不同的值。 | 绑定到类本身，所有实例共享相同的值，或全局常量。 |
| 作用域 | 实例级别，属于对象的一部分。 | 类级别或全局级别，不依赖于对象实例。 |
| 类型 | 必须有类型声明。 | 可以是标量、数组或null，但不能是对象或资源。 |
| 用途 | 创建不可变数据对象，确保实例数据的稳定性。 | 定义在整个应用程序或类中不变的配置值、状态码等。 |
简而言之，readonly属性适用于需要为每个对象实例存储不同但不可变的数据，而const适用于存储在整个应用程序或类中都保持不变的固定值。
6. 使用 readonly 的注意事项
在使用readonly属性和类时，需要注意以下几点：
- 类型声明：readonly属性必须拥有类型声明。这是为了确保类型安全，并帮助PHP在编译时进行验证。
- 初始化时机：readonly属性只能在声明时或在构造函数中进行初始化。一旦赋值，就不能再被重新赋值或unset。
- 不可重新赋值：尝试在构造函数之外重新赋值readonly属性，或者在构造函数中多次赋值，都会导致运行时错误。
- 对象内部状态：readonly关键字保证的是属性本身引用的不可变性。如果一个readonly属性存储的是一个可变对象（例如DateTime而不是DateTimeImmutable），那么该对象内部的状态仍然可以通过其公共方法进行修改。为了实现真正的深度不可变性，存储的对象本身也应该是不可变的。
- readonly类：readonly类不能有动态属性。所有属性都必须在类定义中明确声明。
- 继承：readonly类可以被继承，但子类也必须是readonly的。
7. 总结
PHP 8.1引入的readonly属性，以及PHP 8.2对其的扩展——readonly类，是PHP语言在构建健壮、可维护代码方面迈出的重要一步。它们提供了一种简洁、高效的方式来创建不可变对象和属性，极大地减少了传统实现方式中的样板代码。通过确保数据在初始化后不会被意外修改，readonly关键字有助于提升代码的可靠性、可预测性，并降低调试难度。掌握readonly的使用，将使您能够编写出更优雅、更具防御性的PHP代码。
