PHP对象转数组无法原生保留类型，需通过JsonSerializable接口、反射+类型标注、预处理或自定义toArray()等方案实现语义保留与可逆转换。
PHP对象转数组时，原生方式基本无法保留原始数据类型。因为数组是弱类型容器，而对象属性可能包含 DateTime、Closure、Resource、SimpleXML 或自定义对象等不可直接映射为数组元素的类型。所谓“保留类型”，实际是指在转换后仍能准确还原或识别其语义（如把 DateTime 保持为时间对象而非字符串，把枚举保持为枚举实例而非 int/string）。关键不在于“数组里存类型”，而在于转换过程可控、信息不丢失、后续可逆或可解释。
用 JsonSerializable 接口精准控制序列化行为
这是官方推荐、最健壮的高级方案，适用于自定义类，能完全决定哪些字段导出、如何格式化、是否保留类型语义：
- 实现
JsonSerializable接口，在jsonSerialize()方法中返回你想要的结构——可以是纯标量数组，也可以是嵌套对象（只要它们也支持序列化） - 配合
json_encode($obj)+json_decode(..., true)使用，虽最终是数组，但输出内容已按业务逻辑“类型友好”地组织好 - 例如：将
DateTime输出为 ISO8601 字符串，同时加"@type": "datetime"元数据字段，下游可据此重建对象 - 优势：不依赖反射、不暴露私有属性、可过滤敏感字段、支持递归、与 API 标准天然兼容
结合反射 + 类型标注做智能降级
当需要在 toArray() 中保留类型线索（比如用于调试、日志或配置快照），可用 ReflectionClass 提取属性并附带类型信息：
- 遍历所有属性（public/protected/private），调用
$prop->getType()获取 PHP 8+ 的声明类型（如DateTime|int|null） - 对值做安全判断：
$value instanceof DateTime→ 存为['@type' => 'datetime', 'value' => $value->format('c')] - 对
enum值，存为['@type' => 'enum', 'class' => MyEnum::class, 'value' => $value->value] - 结果不是“带类型的数组”，而是“带类型元信息的数组”，便于后续反序列化或校验
避免 JSON 方案的类型陷阱
json_encode/json_decode(..., true) 最常用，但极易丢失类型。高级用法要主动防御：
立即学习“PHP免费学习笔记（深入）”；
- 提前检查不可序列化成员：
array_filter(get_object_vars($obj), function($v) { return !is_resource($v) && !is_callable($v); }) - 对 DateTime 等常见类型，先统一预处理：
$obj->created_at = $obj->created_at?->format('c') ?: null; - 用
JSON_THROW_ON_ERROR替代静默失败，配合 try/catch 捕获结构异常 - 绝不依赖
json_decode输出自动还原对象类型——它永远只返回 array 或 stdClass
自定义 toArray() + 类型映射表
在业务核心模型中，定义受控的 toArray() 并内置类型策略：
- 声明一个
protected $cast = ['created_at' => 'datetime', 'status' => MyEnum::class]; - 在
toArray()中遍历$cast，对每个字段按规则转换：match($cast[$key]) { 'datetime' => $this->$key?->format('Y-m-d\TH:i:s.uO'), MyEnum::class => $this->$key?->value } - 既保证输出是干净数组，又让类型逻辑集中、可测试、可复用
- Laravel Eloquent 的
$casts和toArray()就是这种思想的成熟实践
