PHP对象转数组嵌套技巧详解

本文深入解析了PHP中将对象高效、灵活地转换为数组的五种核心技巧：从最简捷的强制类型转换（仅限公有属性），到借助JSON编解码穿透私有/受保护字段，再到通过实现JsonSerializable接口精细控制序列化逻辑；进一步覆盖利用Reflection API递归遍历实现全属性深度转换，以及在业务类中定义显式toArray()方法以统一处理嵌套结构、格式化和敏感数据过滤——无论你是追求简洁、兼容性、安全性还是可维护性，都能在这里找到适配不同场景的最佳实践方案。

一、使用强制类型转换（array）

PHP中可直接对对象使用强制类型转换语法（array）将其转为关联数组，该操作会将对象的**公有属性**及其值映射为数组键值对，私有和受保护属性不可见，且不触发任何魔术方法。

1、定义一个具有公有属性的类，例如：class User { public $name = 'Alice'; public $age = 30; }

2、实例化该类：$user = new User();

3、执行强制转换：$arr = (array) $user;

4、输出结果将得到：['name' => 'Alice', 'age' => 30]

二、调用json_encode与json_decode组合

该方式通过JSON中间格式实现对象到数组的转换，能穿透访问**所有可序列化的属性**（包括受保护和私有属性），前提是对象未定义__sleep或__serialize限制，且属性值为JSON可表示类型。

1、对对象调用json_encode($obj)，获得JSON字符串

2、对该字符串调用json_decode($json, true)，第二个参数设为true以返回关联数组而非stdClass对象

3、注意：资源类型、闭包、循环引用会导致json_encode失败并返回false

4、示例中若对象含私有属性$id，其键名在数组中将表现为"\0*\0id"或"\0User\0id"格式

三、实现JsonSerializable接口

让对象主动声明其序列化行为，通过实现JsonSerializable接口并定义jsonSerialize()方法，可精确控制哪些数据参与转换，适用于需过滤敏感字段或嵌套结构重组的场景。

1、在类定义中添加implements JsonSerializable

2、实现public function jsonSerialize()方法

3、在该方法内返回一个数组，例如：return ['name' => $this->name, 'level' => $this->getLevel()];

4、后续调用json_decode(json_encode($obj), true)即可获得定制化数组

四、递归遍历对象属性（Reflection API）

利用反射机制可完整读取对象所有属性（含私有、受保护），并支持深度遍历嵌套对象，适用于复杂对象图结构的完全扁平化或树状数组化需求。

1、创建ReflectionObject实例：$ref = new ReflectionObject($obj);

2、获取全部属性：$props = $ref->getProperties();

3、遍历每个属性，设置可访问性：$prop->setAccessible(true);

4、读取值并判断是否为对象：若是，则递归调用同一转换逻辑；否则直接赋值

5、构造结果数组时，私有属性键名按反射规范保留命名空间前缀，如"\0ClassName\0property"

五、定义toArray()实例方法

在业务类中显式声明toArray()方法，提供稳定可控的转换入口，便于统一处理日期格式化、关系对象展开、空值归一等业务逻辑，是面向对象设计中推荐的显式契约方式。

1、在类中添加公共方法：public function toArray() { ... }

2、方法体内手动构建数组，例如：$data['id'] = (int) $this->id;

3、对关联对象调用其自身的toArray()，实现嵌套转换：$data['profile'] = $this->profile->toArray();

4、对集合属性使用array_map封装：$data['tags'] = array_map(fn($t) => $t->toArray(), $this->tags);

本篇关于《PHP对象转数组嵌套技巧详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！