PHP 8.1 readonly 属性详解：构建不可变对象的现代方法

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属性的定义变得更加简洁：

千帆大模型平台

面向企业开发者的一站式大模型开发及服务运行平台

35

查看详情

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适用于存储在整个应用程序或类中都保持不变的固定值。

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中文网其它相关文章！