在开发过程中，我需要将用户提交的 JSON 数据转换为严格的 PHP 对象，以便在后续的业务逻辑中使用。这些对象包括命令（Command）对象和查询（Query）对象。最初，我尝试手动编写转换代码，但发现这不仅耗时，而且容易出错。尤其是当数据结构复杂时，处理起来更加棘手。
这时，我发现了 eventsauce/object-hydrator 这个库。它可以将结构化数据（如 JSON）转换为严格的 PHP 对象，并且支持反向操作——将对象序列化为结构化数据。它的安装非常简单，只需运行以下命令：
composer require eventsauce/object-hydrator
使用这个库，我可以轻松地将 JSON 数据转换为对象。例如：
use EventSauce\ObjectHydrator\ObjectMapperUsingReflection;
$mapper = new ObjectMapperUsingReflection();
class ExampleCommand
{
public function __construct(
public readonly string $name,
public readonly int $birthYear,
) {}
}
$command = $mapper->hydrateObject(
ExampleCommand::class,
[
'name' => 'de Jonge',
'birth_year' => 1987
],
);
// 现在 $command 是一个 ExampleCommand 对象不仅如此，这个库还支持复杂的对象嵌套和数组转换。例如：
立即学习“PHP免费学习笔记（深入）”；
class ChildObject
{
public function __construct(
public readonly string $value,
) {}
}
class ParentObject
{
public function __construct(
public readonly string $value,
public readonly ChildObject $child,
) {}
}
$command = $mapper->hydrateObject(
ParentObject::class,
[
'value' => 'parent value',
'child' => [
'value' => 'child value',
]
],
);此外，eventsauce/object-hydrator 还提供了灵活的自定义映射和类型转换功能。你可以使用属性（attributes）来指定自定义的键映射和类型转换。例如：
use EventSauce\ObjectHydrator\MapFrom;
class ExampleCommand
{
public function __construct(
public readonly string $name,
#[MapFrom('year')]
public readonly int $birthYear,
) {}
}在性能方面，这个库通过预编译的方式生成优化后的映射代码，可以实现比反射（reflection）快 3-10 倍的性能提升。
总的来说，eventsauce/object-hydrator 库不仅简化了 PHP 对象的序列化和反序列化过程，还提供了强大的自定义和性能优化功能。它让我能够专注于业务逻辑，而不必担心数据转换的细节，大大提高了开发效率。如果你也面临类似的问题，不妨尝试一下这个库。
