PHP反射：getStaticProperties与getStaticPropertyValue静态属性可见性差异问询

开发者阿泽

2026-5-11

关于PHP ReflectionClass中getStaticProperties与getStaticPropertyValue的行为差异

这确实是PHP反射API里一个容易让人摸不着头脑的设计点，我来帮你理清楚背后的逻辑：

1. 两个方法的设计目标本质不同

getStaticProperties()：它的核心定位是类结构的元信息查询工具。反射的初衷就是让开发者能够洞察类的完整内部结构——不管属性的访问修饰符是什么，它都属于类定义的一部分。所以这个方法会返回所有静态属性（包括私有、受保护、公共），这完全符合反射“暴露类元信息”的职责。
getStaticPropertyValue()：它的定位更偏向于模拟常规代码的属性访问行为。也就是说，它会严格遵循PHP的访问权限控制规则——就像你在类外部直接访问RCE::$pri会报错一样，这个方法也会检查当前上下文是否有权限读取目标属性，没有权限就抛出ReflectionException。这是为了保持反射在“操作属性值”这个场景下和普通代码的一致性，避免无限制绕过权限带来的安全或逻辑问题。

2. 如何获取私有/受保护静态属性的值？

如果确实需要读取这类属性的值，可以借助ReflectionProperty对象的setAccessible()方法来临时解除权限限制：

class RCE { 
    protected static $pri = 'Private static property'; 
    protected static $pro = 'Protected static property'; 
    public static $pub = 'Public static property'; 
} 

$rce = new ReflectionClass('RCE');
// 获取私有静态属性的ReflectionProperty对象
$priProp = $rce->getProperty('pri');
// 临时设置为可访问
$priProp->setAccessible(true);
// 现在可以读取值了
var_dump($priProp->getValue());