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

在日常的php开发中，我们常常会遇到这样的场景：从外部接口接收到一大串json数据，或者从数据库中查询出一条记录，它们通常都被解析成php数组。为了方便，我们可能直接在代码中通过 array[‘key’] 的方式来访问数据。起初这似乎没什么问题，但随着项目规模的扩大和业务逻辑的复杂化，这种方式的弊端就逐渐显现出来了：

1. 可读性差：一个数组可能包含几十个键值对，如果不看文档，很难一眼看出这个数组到底代表了什么，有哪些必填字段，哪些是可选的。
2. 缺乏类型安全：PHP数组本身不强制类型，你可能期望某个键是字符串，结果却收到了一个整数，这很容易导致运行时错误。
3. 难以维护：如果数据结构发生变化，你需要手动修改所有用到这个数组的地方，稍有遗漏就可能引发线上问题。
4. 数据易被篡改：数组是可变的，在代码的不同地方，数据可能会被无意中修改，导致难以追踪的bug。

为了解决这些痛点，我们通常会引入“数据传输对象”（Data Transfer Object，简称DTO）的概念。DTO是一种设计模式，它将数据封装成一个对象，提供清晰的结构和类型定义。然而，手动为每个数据结构编写DTO类，包括构造函数、属性、getter方法等，又会带来大量的样板代码。

这时，phpexperts/simple-dto 这个Composer包就如同救星一般出现了。它是一个轻量级且功能强大的DTO实现，旨在简化DTO的创建和使用，同时提供类型安全和不可变性。

phpexperts/simple-dto：让数据结构清晰可见

phpexperts/simple-dto 的核心理念是：将数组数据映射到带有明确类型定义的类属性上，并确保对象一旦创建就不可更改（Immutable）。这意味着你的数据将变得可预测，且在应用程序的不同层级传递时保持一致性。

安装与基本使用

首先，通过Composer轻松安装：

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

composer require phpexperts/simple-dto

接下来，我们来看看如何定义一个简单的DTO。假设我们需要处理用户的生日信息，包含姓名和生日日期：

百度文心百中

百度大模型语义搜索体验中心

32

查看详情

<pre class="brush:php;toolbar:false;">use CarbonCarbon; use PHPExpertsSimpleDTOSimpleDTO;  /**  * @property-read string $name  * @property-read Carbon $date  */ class BirthdayDTO extends SimpleDTO {     /** @var string */     protected $name;      /** @var Carbon */     protected $date; }  // 实例化DTO $birthdayDTO = new BirthdayDTO([     'name' => 'John Doe',     'date' => '1990-01-15', ]);  // 访问数据，如同访问普通对象属性 echo $birthdayDTO->name; // 输出: John Doe  // 惊艳之处：自动将日期字符串转换为 Carbon 对象 echo $birthdayDTO->date->format('Y年m月d日'); // 输出: 1990年01月15日  // 轻松转换为数组或JSON $dataArray = $birthdayDTO->toArray(); echo json_encode($birthdayDTO, JSON_PRETTY_PRINT);

从上面的例子可以看出，phpexperts/simple-dto 带来了以下显著优势：

1. 清晰的结构定义：通过 @property-read DocBlock 和 protected 类型属性，你可以一目了然地知道DTO包含哪些字段及其类型。
2. 自动类型转换：对于 Carbon 或 CarbonCarbon 类型的属性，它会自动将日期字符串转换为 Carbon 对象，省去了手动转换的麻烦。
3. 不可变性：一旦 BirthdayDTO 对象创建，其内部属性就不能被修改。如果需要修改数据，你必须创建一个新的DTO实例，这极大地提高了数据的可预测性和代码的健壮性。
4. 便捷的序列化：内置 toArray() 和 json_encode() 支持，方便将DTO转换为数组或JSON字符串。

更多高级特性

phpexperts/simple-dto 还提供了一些高级功能，以适应更复杂的场景：

• WriteOnce Trait：有时，你可能需要在DTO创建后，在某个特定时机设置一次属性（例如，在多步骤表单中）。WriteOnce Trait 允许你将某些属性初始化为 null，然后只设置一次。
• #[IgnoreAsDTO] Attribute (PHP 8+)：如果你有一些 protected 属性不希望被DTO机制管理，可以使用此属性将其排除。
• NestedDTOs：当你的数据结构包含其他复杂对象时，NestedDTOs 允许你轻松地嵌套DTO，构建出多层级的数据模型。例如，一个订单DTO可以包含一个客户DTO和多个商品DTO。

<pre class="brush:php;toolbar:false;">use PHPExpertsSimpleDTONestedDTO; use PHPExpertsSimpleDTOSimpleDTO;  /**  * @property-read string $productName  * @property-read int $quantity  */ class ProductDTO extends SimpleDTO {     protected string $productName;     protected int $quantity; }  /**  * @property-read string $orderId  * @property-read ProductDTO[] $products  */ class OrderDTO extends NestedDTO {     protected string $orderId;     protected array $products; // 数组中的每个元素都会被自动转换为 ProductDTO }  $order = new OrderDTO([     'orderId' => 'ORD-2023001',     'products' => [         ['productName' => 'Laptop', 'quantity' => 1],         ['productName' => 'Mouse', 'quantity' => 2],     ] ]);  echo $order->products[0]->productName; // 输出: Laptop

总结其优势与实际应用效果

使用 phpexperts/simple-dto，你的PHP代码将变得：

• 更易读：通过DTO的类定义，数据结构一目了然。
• 更健壮：类型安全和不可变性减少了运行时错误和意外数据修改的风险。
• 更易维护：数据结构变更时，只需修改DTO定义，IDE也能提供更好的重构支持。
• 更高效：减少了手动验证和转换数据的样板代码。
• 架构更清晰：促进了不同层级之间的数据传输规范化，提升了代码质量。

无论你是在构建API、处理表单提交，还是在应用程序的不同模块之间传递数据，phpexperts/simple-dto 都能帮助你将混乱的数组数据转化为清晰、安全、可维护的对象，让你的PHP项目开发体验更上一层楼。告别那些令人头疼的 array[‘undefined_key’] 错误吧，拥抱结构化和类型安全的数据传输！