PHP ReflectionClass getProperties 怎样只读取公开属性

如果反射结果里同时出现 public、protected 和 private 属性，问题通常不在遍历，而在 ReflectionClass::getProperties() 没有传筛选条件。只想处理公开属性时，把 ReflectionProperty::IS_PUBLIC 作为 filter 传进去即可。

官方文档：https://www.php.net/manual/en/reflectionclass.getproperties.php

getProperties(ReflectionProperty::IS_PUBLIC) 返回的是公开属性对应的 ReflectionProperty 反射对象，不是属性值数组；需要值时，再对具体对象调用 getValue()。

先定位“属性太多”的原因

ReflectionClass::getProperties() 的 filter 参数默认是 null，这意味着它会返回所有类型的属性。下面的类故意放入三种可见性，便于看出筛选边界。

getProperties();

foreach ($all as $property) {
    // getName() 读取的是元数据名称，不会读取属性值。
    echo $property->getName() . PHP_EOL;
}

这里的返回数组元素都是 ReflectionProperty。它们描述属性的名称、声明类和修饰符；把这个数组直接当成业务字段值使用，是最常见的误读。

用 IS_PUBLIC 只保留公开属性

将筛选常量作为第二步传给 getProperties()，反射层就只返回公开属性。这个筛选发生在反射查询阶段，调用方不必先取出全部属性再用字符串比较。

getProperties(
    ReflectionProperty::IS_PUBLIC
);

foreach ($publicProperties as $property) {
    // 这里仍然是 ReflectionProperty；getName() 只确认字段名。
    echo $property->getName() . PHP_EOL;
}

结果中只有 name 对应的反射对象。若类里没有公开属性，返回的仍是空数组，不会因为筛选不到结果而自动放宽到其他可见性。

别把反射对象和属性值混在一起

getProperties() 解决的是“有哪些属性符合条件”，而不是“这些属性当前存了什么”。如果确实需要读取实例上的公开属性值，可以先取得反射对象，再把目标实例传给 getValue()。

getProperties(ReflectionProperty::IS_PUBLIC);

foreach ($publicProperties as $property) {
    // getValue() 针对当前实例读取值；这里不会触碰 protected/private 属性。
    $value = $property->getValue($account);
    echo $property->getName() . ': ' . $value . PHP_EOL;
}

如果只是做字段名白名单、序列化前的元数据扫描或生成文档，到 getName() 就可以结束。只有确实需要实例数据时才调用 getValue()，这样职责更清楚。

需要多种可见性时再组合常量

filter 不只支持单个常量。想同时取得公开和受保护属性，可以用按位或组合 ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PROTECTED；省略 filter 则表示全部属性。

getProperties(
    ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PROTECTED
);

foreach ($visibleToReport as $property) {
    // isPublic/isProtected 可用于在输出前再次表达当前边界。
    echo $property->getName() . PHP_EOL;
}

这里的组合只改变返回哪些 ReflectionProperty 对象，不会修改类的可见性，也不会绕过访问控制。如果需求是改变属性值，应单独评估 setValue() 的对象、类型和业务约束。

常见问题

只读取公开属性必须调用 isPublic() 吗？

不必须。把 ReflectionProperty::IS_PUBLIC 传给 getProperties() 就能完成集合筛选；isPublic() 更适合对单个反射对象做补充判断。

getProperties() 返回属性值吗？

不返回。它返回 ReflectionProperty 对象数组，名称用 getName() 读取，实例值用具体对象调用 getValue() 读取。

可以同时筛选公开和私有属性吗？

可以，用 ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PRIVATE 组合。若没有明确筛选边界，才使用不带参数的调用。

小结

PHP 反射筛选公开属性的最小写法是 $reflection->getProperties(ReflectionProperty::IS_PUBLIC)。记住三点：filter 决定返回哪些反射对象，getName() 读元数据，getValue() 才读实例值；多个可见性需求则用按位或组合常量。