PHP中将对象转数组有五种方法:一是强制类型转换(array),保留所有属性但私有/受保护属性键名带前缀;二是get_object_vars(),仅返回public属性;三是JSON编码解码,可绕过可见性限制但要求值可序列化;四是自定义__toArray()方法,灵活性最高;五是反射API,可获取全部属性值。

一、使用强制类型转换
PHP 支持通过 (array) 强制类型转换将对象转换为数组,该操作会将对象的公共属性(public)作为键值对导入数组,私有(private)和受保护(protected)属性会被添加前缀修饰符,影响键名结构。
1、定义一个包含 public、protected 和 private 属性的类实例。
2、在需要转换的位置,使用 (array)$obj 语法执行转换。
3、注意:转换后 protected 属性键名为 \0*\0property_name,private 属性键名为 \0Classname\0property_name,需正则或字符串处理方可统一访问。
立即学习“PHP免费学习笔记(深入)”;
二、使用 get_object_vars() 函数
get_object_vars() 仅返回对象中可访问的 public 属性组成的关联数组,不包含 protected 或 private 成员,适合明确只需公开字段的场景,且不依赖属性可见性修饰符干扰键名。
1、确保目标对象实例化完成且至少存在一个 public 属性。
2、调用 get_object_vars($obj),传入对象变量。
3、函数返回结果为纯关联数组,键为属性名,值为对应当前值,无额外命名空间前缀。
三、通过 JSON 编码与解码中转
利用 json_encode() 将对象序列化为 JSON 字符串,再用 json_decode($json, true) 强制解析为关联数组,可绕过可见性限制并扁平化嵌套对象,但要求所有属性值均可 JSON 序列化。
1、确认对象中不含资源(resource)、闭包(Closure)或循环引用,否则 json_encode 将失败或返回 false。
2、执行 $arr = json_decode(json_encode($obj), true)。
3、该方式会丢失原始属性的可见性标识,所有键均为纯字符串,且 DateTime 等对象将转为 ISO8601 字符串形式。
四、实现 __toArray() 自定义方法
在类内部定义显式的 __toArray() 魔术方法或普通公有方法,由开发者控制哪些属性参与转换、是否递归处理子对象、是否格式化值,提供最高灵活性和可维护性。
1、在类中声明 public function __toArray() { ... }。
2、方法体内手动构造数组,例如 return ['id' => $this->id, 'name' => $this->name]。
3、支持对 DateTime、其他对象等调用各自 __toArray() 或 format() 方法,实现深度可控转换。
五、使用反射 API 提取全部属性
借助 ReflectionClass 可突破访问控制,获取 public、protected、private 所有属性的名称与值,并按需构造数组,适用于需完整状态导出且不能修改原类定义的场景。
1、实例化 $ref = new ReflectionClass($obj)。
2、调用 $props = $ref->getProperties() 获取全部属性反射对象列表。
3、遍历 $props,对每个属性调用 $prop->setAccessible(true); $arr[$prop->getName()] = $prop->getValue($obj)。











