PHP8.1readonly属性克隆难题如何解决？spatie/php-cloneable助你轻松搞定！-composer-PHP中文网

PHP8.1readonly属性克隆难题如何解决？spatie/php-cloneable助你轻松搞定！

WBOY

发布： 2025-09-02 12:14:24

原创

283人浏览过

可以通过一下地址学习composer：学习地址

在 php 8.1 发布之后，

readonly

登录后复制

属性无疑成为了许多开发者心头好。它强制了属性在初始化后不可更改，这对于构建可靠的不可变对象（immutable objects）和值对象（value objects）来说简直是福音。想象一下，你的

user

登录后复制

对象、

order

登录后复制

对象或者

configuration

登录后复制

对象，一旦创建，其核心属性就无法被意外修改，这大大提升了代码的健壮性和可预测性。

然而，在实际开发中，我们常常会遇到一个看似矛盾的需求：我有一个不可变对象，但我想基于它创建一个“新版本”，仅仅修改其中一两个属性，而保持原始对象不变。例如，一个

Post

登录后复制

对象，我想创建一个新的

Post

登录后复制

实例，它拥有相同的内容，但标题略有不同。

<pre class="brush:php;toolbar:false;">class Post
{
    public readonly string $title;
    public readonly string $author;
    public readonly string $content;

    public function __construct(string $title, string $author, string $content)
    {
        $this->title = $title;
        $this->author = $author;
        $this->content = $content;
    }
}

$originalPost = new Post('旧标题', '张三', '这是一篇旧文章的内容。');

// 试图克隆并修改标题，但 readonly 属性不允许重新赋值！
// $newPost = clone $originalPost;
// $newPost->title = '新标题'; // 这会抛出错误！

登录后复制

直接对

readonly

登录后复制

属性进行重新赋值显然是不被允许的。那么，难道每次都需要手动创建一个全新的对象，把所有未修改的属性一一复制过去吗？这不仅繁琐，而且容易出错，尤其当对象属性很多时，简直是噩梦。这种“克隆并修改”的需求，在函数式编程范式中被称为“withers”方法，它允许我们基于现有对象创建新对象，同时修改特定属性。

救星驾到：

spatie/php-cloneable

登录后复制

正当我为这种重复而无趣的代码感到沮丧时，开源社区再次展现了它的强大力量。

spatie/php-cloneable

登录后复制

这个 Composer 包，正是为了解决 PHP 8.1 中

readonly

登录后复制

属性的克隆难题而生。它提供了一个简洁优雅的 Trait，让你能够轻松地实现带有修改功能的克隆。

这个包的核心思想是：通过一个

with

登录后复制

方法，以“不可变更新”的方式，基于当前对象创建一个新的对象实例，并允许你指定要修改的属性值。

立即学习“PHP免费学习笔记（深入）”；

Browse AI

AI驱动的网页内容抓取和数据采集工具

查看详情

如何使用

spatie/php-cloneable

登录后复制

首先，通过 Composer 轻松安装它：

<pre class="brush:php;toolbar:false;">composer require spatie/php-cloneable

登录后复制

接下来，在你的类中引入

Spatie\Cloneable\Cloneable

登录后复制

Trait 即可：

<pre class="brush:php;toolbar:false;">use Spatie\Cloneable\Cloneable;

class Post
{
    use Cloneable; // 引入 Cloneable Trait

    public readonly string $title;
    public readonly string $author;
    public readonly string $content;

    public function __construct(string $title, string $author, string $content)
    {
        $this->title = $title;
        $this->author = $author;
        $this->content = $content;
    }
}

$originalPost = new Post('旧标题', '张三', '这是一篇旧文章的内容。');

// 现在，我们可以使用 with 方法来创建一个新 Post 实例，并修改其标题
$newPost = $originalPost->with(title: '新标题'); // 注意：这里必须使用命名参数！

echo "原始文章标题: " . $originalPost->title . PHP_EOL; // 输出: 旧标题
echo "新文章标题: " . $newPost->title . PHP_EOL;       // 输出: 新标题

// 也可以同时修改多个属性
$postByLiSi = $originalPost->with(title: '李四的文章', author: '李四');
echo "李四的文章标题: " . $postByLiSi->title . ", 作者: " . $postByLiSi->author . PHP_EOL;

// 为了更好的可读性和封装性，你可以在类中定义特定的 with* 方法
class PostWithHelpers
{
    use Cloneable;

    public readonly string $title;
    public readonly string $author;
    public readonly string $content;

    public function __construct(string $title, string $author, string $content)
    {
        $this->title = $title;
        $this->author = $author;
        $this->content = $content;
    }

    public function withTitle(string $title): self
    {
        return $this->with(title: $title);
    }

    public function withAuthor(string $author): self
    {
        return $this->with(author: $author);
    }
}

$anotherPost = new PostWithHelpers('原创标题', '王五', '内容...');
$modifiedPost = $anotherPost->withTitle('修改后的标题')->withAuthor('赵六');

echo "修改后的文章标题: " . $modifiedPost->title . ", 作者: " . $modifiedPost->author . PHP_EOL;

登录后复制

spatie/php-cloneable

登录后复制

的

with

登录后复制

方法会在底层创建一个新的对象实例，然后将原始对象的所有属性复制过去，最后再用你提供的参数覆盖对应的属性。由于它在内部巧妙地处理了

readonly

登录后复制

属性的限制，你无需担心任何错误。

优势与实际应用效果

优雅地处理不可变对象更新： 这是其最核心的优势。它让 PHP 8.1 的
```
readonly
```
登录后复制
属性与“克隆并修改”的需求完美结合，避免了手动复制属性的繁琐和潜在错误。
代码更清晰、意图更明确： 使用
```
with(propertyName: $value)
```
登录后复制
或自定义的
```
withPropertyName($value)
```
登录后复制
方法，代码的意图一目了然，明确表示我们正在基于现有对象创建一个新版本。
提高代码可维护性： 当你的对象属性发生变化时，你只需要修改
```
with
```
登录后复制
方法的调用或对应的
```
with*
```
登录后复制
辅助方法，而不需要修改所有手动复制属性的地方。
适用于多种场景： 无论是构建值对象、配置对象，还是在 DDD 中处理聚合根的不可变状态，
```
spatie/php-cloneable
```
登录后复制
都能提供极大的便利。它让你的代码在享受
```
readonly
```
登录后复制
带来的安全性的同时，保持了应有的灵活性。