PHP对象转数组“丢失属性”实为可见性限制或序列化问题：公有属性默认可见，私有/受保护属性在强制转换中带不可见前缀，get_object_vars()则完全忽略；JSON序列化遇资源、闭包等会失败；反射或自定义toArray()方法可完整可控导出。
PHP对象转数组时“丢失属性”，通常不是真丢失，而是属性没被正确读取或显示——比如私有/受保护属性被忽略、键名带不可见前缀、JSON序列化失败、或魔术方法干扰。关键看你想保留哪些属性、是否需要递归、以及对象是否可序列化。
检查属性可见性：公有属性才默认可见
get_object_vars() 和 (array) 强制转换都只对 public 属性“友好”。private 和 protected 属性不会消失，但表现不同：
- get_object_vars()：完全不返回 private/protected 属性，结果里压根没有它们；
-
(array)$obj：会保留 private/protected 属性，但键名变成类似
\0User\0id（private）或\0*\0name（protected），用var_dump()能看到，但foreach或isset($arr['id'])会失效；
✅ 解决办法：若需所有属性，别依赖 get_object_vars()；若用强制转换，用 array_keys($arr) 查看真实键名，或用正则清理前缀（如 preg_replace('/^\x00(?:[^\x00]+|\*)\x00/', '', $key)）。
确认对象是否可 JSON 序列化
json_encode/json_decode 组合看似万能，但遇到不可序列化内容会静默失败或丢数据：
立即学习“PHP免费学习笔记（深入）”；
- 资源类型（
resource）、闭包（Closure）、循环引用 →json_encode()返回false； -
DateTime、SimpleXML、自定义对象 → 若未实现JsonSerializable，可能转为空对象或字符串，甚至报错； - 属性值为
null或空数组，在解码后仍存在，但容易被误判为“丢失”。
✅ 解决办法：先检查 $json = json_encode($obj); if ($json === false) { echo json_last_error_msg(); }；对特殊对象，提前在类中实现 JsonSerializable::jsonSerialize()，只返回你想导出的字段。
用反射获取全部属性（含私有/受保护）
当必须完整还原对象结构，又不能改原始类时，ReflectionClass 是最可控的方式：
- 它能列出所有属性（public/protected/private），调用
setAccessible(true)后可安全读值； - 可递归处理嵌套对象（判断
is_object($val) && method_exists($val, 'toArray')）； - 避免 JSON 的类型擦除问题（比如保持 int 不变，而非转成 string）。
✅ 示例片段：
$ref = new ReflectionClass($obj);$result = [];
foreach ($ref->getProperties() as $prop) {
$prop->setAccessible(true);
$key = $prop->getName();
$val = $prop->getValue($obj);
// 可选：对嵌套对象递归调用 $val->toArray() 或反射处理
$result[$key] = $val;
}
优先在类中定义 toArray() 方法
最健壮的做法，是让对象自己决定怎么转数组：
- 明确控制哪些字段导出（过滤敏感属性、格式化日期、计算派生字段）；
- 天然支持递归：
return ['id' => $this->id, 'profile' => $this->profile->toArray()]； - 兼容 Laravel/Eloquent 模型的
toArray()行为，便于统一维护。
✅ 建议模板：
public function toArray(): array {return [
'id' => $this->id,
'name' => $this->name,
'created_at' => $this->createdAt?->format('Y-m-d H:i:s'),
'tags' => array_map(fn($t) => $t->toArray(), $this->tags),
];
}
