PHP对象转数组技巧：json_decode与get_object_vars对比

在PHP开发中，将对象高效、准确地转换为数组是序列化数据、构建API响应或调试输出的关键环节，但不同场景需匹配不同方法：json_decode($json, true)专用于JSON字符串的直接数组解析；get_object_vars()安全提取public属性；(array)强制转换虽快捷却对自定义类支持有限且行为不稳定；ReflectionObject可突破访问限制获取全部属性但性能开销较大；而最规范、可控、可维护的方式是在自定义类中实现专属toArray()方法——它赋予开发者完全的字段控制权、格式化能力和嵌套处理逻辑，真正兼顾健壮性与可扩展性。

如果您在 PHP 开发中需要将对象转换为数组，常见场景包括数据序列化、API 响应构造或调试输出，则需根据对象类型（标准对象、JSON 字符串解析所得对象、自定义类实例）选择合适的方法。以下是几种可靠且互不替代的转换方式：

一、使用 json_decode($json, true) 转换 JSON 字符串解析后的对象

该方法适用于已通过 json_decode($json) 得到的 stdClass 对象，本质是将原始 JSON 字符串重新以关联数组模式解析，绕过对象中间态。它不适用于普通 PHP 对象或已实例化的类对象。

1、确保原始数据为合法 JSON 字符串，例如：$json_str = '{"name":"Alice","age":30}';

2、调用 json_decode 并传入第二个参数 true：json_decode($json_str, true)

3、返回结果为纯关联数组，键名与 JSON 中字段名完全一致，无对象属性访问语法限制。

二、使用 get_object_vars() 获取对象的可访问公共属性

该函数仅提取对象的 public 作用域属性，忽略 private 和 protected 成员，也不触发 __get 魔术方法。适用于标准类实例，要求属性可直接读取。

1、定义一个含 public 属性的对象，例如：class User { public $name = 'Bob'; public $score = 85; }

2、实例化后调用：get_object_vars($userInstance)

3、返回数组键名为属性名，值为对应 public 属性当前值；若对象无 public 属性，则返回空数组。

三、使用 (array) 强制类型转换

该操作会将对象强制转为数组，但行为依赖对象类型：对 stdClass 有效，对自定义类则仅包含 public 属性且键名带类名前缀（PHP 7.2+ 已移除私有/保护属性前缀，但仍不包含非 public 成员）。

1、对 stdClass 实例：$obj = json_decode('{"x":1,"y":2}'); $arr = (array)$obj;

2、对自定义类实例：$arr = (array)$customObj; 此时数组键可能形如 "\0*\0prop"（旧版本）或 "prop"（新版本），但 private/protected 属性仍不可见。

3、该方式不调用任何魔术方法，也不检查属性可见性逻辑，属底层内存结构映射，不推荐用于生产环境中的自定义类。

四、遍历 ReflectionObject 获取全部属性（含 private/protected）

当需完整导出对象所有属性（无论访问控制修饰符），且不能修改原类时，可借助反射机制。此方法能访问并读取 private 和 protected 属性值，但需确保属性非动态生成且未被 __get 拦截。

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

2、获取全部属性（含非 public）：$props = $ref->getProperties()

3、遍历 $props，对每个属性调用 $prop->setAccessible(true) 后读取值：$prop->getValue($obj)

4、手动构建关联数组，键名使用 $prop->getName()，值为 getValue() 返回结果。

五、在类中实现 toArray() 方法（面向对象规范做法）

对于自定义类，最可控的方式是在类内部定义明确的 toArray() 方法，由开发者决定哪些字段参与转换、是否进行格式处理或权限过滤。该方法规避了反射开销与可见性限制，也便于单元测试和维护。

1、在类中声明 public function toArray(): array { ... }

2、方法体内显式返回关联数组，例如：return ['id' => $this->id, 'name' => $this->name, 'created_at' => $this->createdAt->format('c')]

3、若存在嵌套对象，可在 toArray() 中递归调用其 own toArray()，确保整棵树结构可预测。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP对象转数组技巧：json_decode与get_object_vars对比》文章吧，也可关注golang学习网公众号了解相关技术文章。