PHP 8.2对反射子系统做了不少底层调整，其中最容易让老项目踩坑的，就是使用ReflectionClass获取类属性时返回结果和预期不一致。过去在PHP 8.1中写的遍历属性代码，升级后可能突然漏掉只读属性或者抛出不明警告。这背后并不是反射坏了，而是API的默认行为和常量定义发生了变化。
PHP 8.2反射类API的核心变动
在PHP 8.2中，ReflectionClass的getProperties方法依然可用，但关于属性修饰符的常量被重新梳理。最明显的是新增了ReflectionProperty::IS_READONLY，用于标记只读属性。如果代码中只传了ReflectionProperty::IS_PUBLIC，那么用readonly修饰的公共属性不会被返回，因为只读标志独立于传统可见性。很多项目从8.1升级后没有意识到这一点，就以为反射拿不到属性。
另一个容易被忽略的点是，ReflectionProperty现在对类型声明检查更严格。在8.1里通过getProperties获取的未初始化typed property，在8.2里如果类使用了新的类型系统特性，反射会返回更精确的getType信息，但要求调用方显式处理。也就是说，反射没有删功能，而是把以前模糊的边界清晰化了，开发者必须按新规则传参。
我们可以通过一段对比代码看清差异。下面示例在PHP 8.1和8.2下运行结果不同：
<?php
class Demo {
public readonly int $id;
public string $name;
}
$ref = new ReflectionClass(Demo::class);
// PHP 8.1会返回id和name，8.2只返回name
$props = $ref->getProperties(ReflectionProperty::IS_PUBLIC);
foreach ($props as $p) {
echo $p->getName() . PHP_EOL;
}
?>
显式声明过滤标志的修复方案
解决该问题最直接的办法，是在调用getProperties时把只读标志也加进去。PHP 8.2提供了按位或的组合方式，可以一次性拿到公共且只读的属性。改写后的过滤参数应当写成ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_READONLY。这样无论属性是否只读，只要可见性是public就都能枚举到。
如果项目需要兼容PHP 8.1和8.2，就不能直接在老版本里写IS_READONLY，因为该常量在8.1不存在。我们可以用class_exists或defined先做判断，动态拼装参数。下面封装了一个安全获取全部公共属性的函数，在低版本自动忽略只读标志：
<?php
function getPublicProps(string $class): array {
$filter = ReflectionProperty::IS_PUBLIC;
if (defined('ReflectionProperty::IS_READONLY')) {
$filter |= ReflectionProperty::IS_READONLY;
}
$ref = new ReflectionClass($class);
return $ref->getProperties($filter);
}
class User {
public readonly int $uid;
public string $uname;
}
foreach (getPublicProps(User::class) as $prop) {
echo $prop->getName() . PHP_EOL;
}
?>
这种写法保证了升级过程平滑。从架构角度看，把反射过滤逻辑收口到统一函数里，也比在业务代码中散落new ReflectionClass更利于维护。当未来PHP 9可能再改反射常量时，只需调整这一个函数。
使用ReflectionProperty读取与校验属性
拿到属性对象后，PHP 8.2还建议在读取前先用isInitialized判断。对于只读属性，如果在构造函数外未赋值，直接getValue会抛异常。反射本身不替你初始化对象，它只描述结构。因此正确的反射遍历应当先判断可见性，再视情况取值。
此外，ReflectionProperty新增的hasType和getType在8.2中返回的是更完整的类型对象，包括交集类型与 nullable 标记。我们可以借助这些信息做自动化文档生成或序列化白名单。示例展示如何安全输出属性及类型：
<?php
class Product {
public readonly float $price;
public ?string $desc;
}
$ref = new ReflectionClass(Product::class);
foreach ($ref->getProperties() as $p) {
$type = $p->hasType() ? $p->getType() : 'mixed';
$readonly = defined('ReflectionProperty::IS_READONLY')
&& $p->getModifiers() & ReflectionProperty::IS_READONLY;
echo $p->getName() . ':' . $type . ($readonly ? ' (readonly)' : '') . PHP_EOL;
}
?>
通过上述方式，我们不仅能解决拿不到属性的问题，还能在反射层面对领域模型做更细粒度的 introspection。这对于写框架、ORM或依赖注入容器的开发者尤其关键，因为反射准确性直接决定了运行时行为是否正确。
避免反射误用的其他建议
虽然反射很强大，但在PHP 8.2里也不该把它当普通数组用。频繁反射会带来性能损耗，尤其在大循环里反复new ReflectionClass。推荐将反射结果缓存到静态变量或opcache友好的结构里。另外，若只是想读公共属性值，优先考虑对象本身的可访问性，而非强制反射破封。
最后要注意，在PHP 8.2中如果类使用了新特性如真枚举或 intersection types，反射返回的信息会和旧版有语义差别。开发者在写通用库时，应当用try-catch包裹反射调用，并对不同版本做分支处理。这样才能在享受语言新特性的同时，不让反射变成隐藏的兼容地雷。
PHP_8.2ReflectionClass反射API更新修改时间：2026-08-13 13:33:17