在 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
正当我为这种重复而无趣的代码感到沮丧时，开源社区再次展现了它的强大力量。
spatie/php-cloneable
这个 composer 包，正是为了解决 PHP 8.1 中
readonly
属性的克隆难题而生。它提供了一个简洁优雅的 Trait，让你能够轻松地实现带有修改功能的克隆。
这个包的核心思想是：通过一个
with
方法，以“不可变更新”的方式，基于当前对象创建一个新的对象实例，并允许你指定要修改的属性值。
立即学习“PHP免费学习笔记（深入）”；
如何使用
spatie/php-cloneable
spatie/php-cloneable
首先，通过 Composer 轻松安装它：
<pre class="brush:php;toolbar:false;">composer require spatie/php-cloneable
接下来，在你的类中引入
SpatieCloneableCloneable
Trait 即可：
<pre class="brush:php;toolbar:false;">use SpatieCloneableCloneable; 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
带来的安全性的同时，保持了应有的灵活性。
小提示
需要注意的是，
spatie/php-cloneable
的
with
方法执行的是浅克隆。这意味着如果你的对象中包含其他对象引用，那么这些嵌套的对象并不会被递归克隆，而是会共享同一个引用。在大多数情况下这已经足够，但如果需要深克隆，你可能需要额外的处理。
总结
spatie/php-cloneable
是一个虽小但功能强大的 Composer 包，它巧妙地解决了 PHP 8.1
readonly
属性在对象克隆和修改时遇到的痛点。通过引入一个简单的 Trait，它让不可变对象的使用变得更加灵活和愉快，大大提升了开发效率和代码质量。如果你正在使用 PHP 8.1 并拥抱不可变性，那么这个库绝对值得你尝试！
评论（已关闭）
评论已关闭