ReflectionClass::getProperties()只返回显式声明的属性，是因为PHP 8.2严格限定其仅扫描类定义结构，不读取运行时对象状态，故动态添加、trait未重声明及只读属性（需setAccessible(true)才能读值）均受此规则约束。
ReflectionClass::getProperties() 为什么只返回显式声明的属性
PHP 8.2 的反射行为变“严”了，不是 bug，是设计收紧：它只扫描类定义结构，不读取运行时对象状态。这意味着 getProperties() 返回的永远是 public $foo; 这类在类体里写死的属性，动态添加的 $obj->bar = 'x'; 或 trait 中未重声明的属性，一律不出现。
常见误判场景：
- 用
new ReflectionClass($obj)反射一个已赋值但未声明属性的对象，却期待看到$obj->dynamicProp - 从 trait 引入属性，但目标类没用
public $prop;显式声明，getProperties()就不包含它 - 用了只读属性（
readonly public string $id;），它仍会被返回，但调用getValue()前必须先setAccessible(true)
setAccessible(true) 在 PHP 8.2+ 为何有时静默失效
PHP 8.1 起引入“敏感属性”概念，8.2 继续强化——某些框架或安全组件会主动拦截对敏感属性的反射访问，setAccessible(true) 可能直接失败或抛出 ReflectionException。
排查要点：
立即学习“PHP免费学习笔记（深入）”；
- 检查属性是否被
#[\Sensitive]或类似自定义属性标注：$prop->getAttributes(\Sensitive::class) - 确认
zend.assertions=1（设为 0 会禁用部分反射能力） - 私有属性必须在
getValue()前调setAccessible(true)，顺序不能颠倒；该调用只对当前ReflectionProperty实例生效 - 静态属性调
getValue()时传null，别传实例
想获取所有属性（含动态、trait、只读），该怎么做
getProperties() 本就不负责运行时状态，所以没有“替代 API”，只有分场景补救：
- 动态属性：PHP 8.2+ 访问未声明属性会触发
E_DEPRECATED，这是语言层最直接约束；确保类没定义__set()/__get()，否则机制被绕过 - trait 属性：必须在目标类中显式声明（哪怕只是
public $prop;），否则反射不可见 - 只读属性：仍可被
getProperties()列出，但读值前必先setAccessible(true) - 运行时对象状态：用
get_object_vars($obj)获取当前对象所有可访问属性（含动态），但它不区分来源、不含类型/可见性信息
只读类和枚举让反射更可靠
PHP 8.2 的 readonly class 和原生 enum 不仅是语法糖，它们从结构上减少了反射歧义：
- 只读类强制所有属性不可变，反射拿到的属性列表与运行时实际状态一致性更高
- 枚举项（如
Status::Active）是单例且类型固定，ReflectionEnum能精确返回cases()、from()等元信息，不再依赖字符串匹配或 magic constants - 属性（Attributes）需通过
ReflectionClass::getAttributes()显式提取，避免过去靠 PHPDoc 注解解析带来的模糊性和类型丢失
健壮性的本质不是“功能更多”，而是“边界更清”——PHP 8.2 的反射不再试图猜测你想要什么，它只告诉你类定义里白纸黑字写了什么。这点在大型项目或框架开发中尤其关键：少一分推测，就少一分线上隐患。
