
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代码。
以上就是PHP 8.1 readonly 属性详解:构建不可变对象的现代方法的详细内容,更多请关注php中文网其它相关文章!


