PHP get_mangled_object_vars 怎样识别私有属性键中的类名

做对象调试或通用导出时，如果直接把 PHP 对象转成数组，私有属性键看起来常常像“多了一段奇怪的类名”。这不是随机前缀，而是 PHP 用属性的声明类和可见性编码出来的键。get_mangled_object_vars() 会返回对象中各层级的已初始化属性：public 保留原名，protected 在名称前加 *，private 则在名称前放入声明类名；protected 和 private 的特殊部分两侧都带有 NUL 字节。

本文围绕一个具体的对象检查接口展开：如何从返回键中识别私有属性属于哪个类，为什么不能只用 str_contains() 猜前缀，以及未初始化类型属性为什么不会出现在结果里。官方参考地址：https://www.php.net/manual/en/function.get-mangled-object-vars.php

先确定接口目标：拿到“编码后的完整属性表”

这个函数适合调试器、对象检查器和需要保留可见性信息的通用工具。它的返回结果不是面向业务调用方的 DTO，也不是把私有属性“变成 public”；它只是把对象当前可取得的属性，以包含可见性线索的数组键返回。

调用方可以把职责分成两层：第一层保留原始键和值，保证诊断信息不丢；第二层再把键解释成声明类、可见性和属性名。这样做比直接把键改写成一个“干净字段名”更稳，因为父类和子类可以各自声明同名 private 属性，丢掉声明类后就会发生碰撞。

调用方需求：先识别属性键的三种形态

最容易误判的是 private 属性。手册中的规则可以写成三个概念模型：

这里的 \0 是字符串里的 NUL 字节，实际值不是两个可见字符“反斜杠”和“0”。遍历时应该使用 strpos($key, "\0") 或按 NUL 拆分，而不是在页面上复制一段看起来像前缀的文本。

参数设计：用原始键保留父子类的同名私有属性

get_mangled_object_vars(object $object): array 只接收一个对象参数，并返回数组。它的价值在于一次拿到所有可见性层级的已初始化属性；代价是数组键承担了编码责任。

下面的示例 deliberately 不把原始键直接改成普通字段名，而是先解析成结构化记录。代码中的 substr() 只在确认有两个 NUL 分隔点后使用，这样 public 键和含有普通字符的属性名不会被误判：

 'public',
            'declaring_class' => null,
            'property' => $key,
            'raw_key' => $key,
        ];
    }

    // 特殊键应当有“起始 NUL + 标记 + 结束 NUL”的结构。
    $parts = explode("\0", $key);
    if (count($parts) !== 3 || $parts[0] !== '') {
        // 保留原始键，避免诊断工具为了追求整齐而丢数据。
        return ['visibility' => 'unknown', 'raw_key' => $key];
    }

    [$empty, $scope, $property] = $parts;
    if ($scope === '*') {
        // 星号表示 protected，第二段不是声明类名。
        return [
            'visibility' => 'protected',
            'declaring_class' => null,
            'property' => $property,
            'raw_key' => $key,
        ];
    }

    // private 键的中间段就是声明该属性的类名。
    return [
        'visibility' => 'private',
        'declaring_class' => $scope,
        'property' => $property,
        'raw_key' => $key,
    ];
}

这个解析函数只解释键的形态，不负责访问私有属性，也不会把同名字段合并。保留 raw_key 很重要：当类名包含命名空间、属性名发生变化或输入来自第三方对象时，原始键是回溯依据。

错误处理：未初始化 typed property 会静默缺席

PHP 的 typed property 如果没有默认值，在赋值前处于 uninitialized 状态。官方手册明确说明，get_mangled_object_vars() 会静默丢弃这类属性。因此“结果数组里没有这个字段”不等于“类没有声明这个字段”，也不等于字段值是 null。

这一区别在通用调试接口中尤其关键。业务层若需要知道字段是否声明过，应把“属性声明存在”和“当前已初始化”分开判断；不要仅凭返回数组是否有键来推断 schema。

需要显式诊断时，可以使用 ReflectionProperty 的 isInitialized()。它的职责是回答“这个属性当前是否已经初始化”，而不是替代 get_mangled_object_vars() 返回完整键值表：

 $property,
        'initialized' => $reflection->isInitialized($object),
    ];
}

如果属性是 private 或 protected，反射对象仍然描述声明信息；真正读取值时还要遵守访问边界。本文的重点只是状态判断：先确认是否初始化，再决定是否把它纳入后续导出或诊断。

兼容策略：不要把三个 API 当成同一种对象转数组

面对对象字段检查，几个看似相近的 API 目标不同：

如果输出要长期存储或跨服务传输，建议先转换为自己的稳定结构，例如 declaring_class、visibility、property、initialized 和 raw_key。不要把带 NUL 的内部键直接当成对外 JSON 字段名；那会把 PHP 的内部表示耦合进接口协议。

示例收束：把键解析和状态诊断分成两步

一个可靠的对象检查器通常按下面的顺序工作：先调用 get_mangled_object_vars() 收集当前实例已经有值的属性；再用键的 NUL 结构解释可见性和声明类；最后对关心但未出现在结果里的声明属性，用 ReflectionProperty 补充初始化状态。这样既不会把父子类的 private 字段合并，也不会把“未出现”误写成“值为空”。

常见问题

为什么私有属性键中间是类名，而不是运行时类名？

因为 private 属性属于声明它的类。子类和父类可以各自拥有同名 private 属性，使用声明类名才能在数组中区分两个字段。

protected 键里的星号是属性名的一部分吗？

不是。它是 PHP 用来标识 protected 可见性的编码标记，真实键在两侧还有 NUL 字节。

未初始化的 typed property 能不能当成 null？

不能。它处于未初始化状态，函数会将其静默排除；如果业务需要区分“未初始化”和“已初始化为 null”，应使用 ReflectionProperty::isInitialized()。

可以把解析后的 property 直接作为业务字段名吗？

不建议。对象内部的可见性编码适合诊断，稳定业务协议应使用自己定义的字段结构，并保留 raw_key 作为排查信息。