直接 new reflectionclass 可获取类元信息而不执行构造逻辑；传类名需注意命名空间，传对象更安全；可用 getmethods()、getproperties() 获取结构，getdoccomment() 提取紧邻 phpdoc 注释；newinstanceargs() 比 newinstance() 更常用因支持显式传参；读私有属性须先调 setaccessible(true)，但 php 8.1+ 有敏感标记限制。
怎么用 ReflectionClass 查看类的结构
直接 new 一个 ReflectionClass 实例，就能拿到类的完整元信息。它不执行构造逻辑，只读取定义，所以哪怕类里有 fatal error 或 require 失败，只要类名能被自动加载器识别，就能反射成功。
常见误操作是传字符串时写错命名空间——比如 new ReflectionClass('User') 在 PSR-4 下大概率报 Class User not found，得写成 new ReflectionClass('App\Models\User')。
- 支持传入对象：
new ReflectionClass($userInstance)，比传类名更安全（自动推导完整类名） - 类不存在会抛
ReflectionException，建议 try/catch 或先用class_exists()判断 - 获取方法列表用
getMethods()，返回ReflectionMethod数组；属性同理用getProperties()
getDocComment() 能提取哪些注释内容
只能提取类、方法、属性声明正上方紧邻的 PHPDoc 块（以 /** 开头、*/ 结尾），中间不能空行。换行或缩进不影响解析，但若写成 // 单行注释或 /* */ 风格，一律返回 null。
实际开发中常用来做路由绑定或依赖注入标记，比如 Laravel 的 @Route、Symfony 的 @ORM\Column 都靠这个提取。
- 类注释：调用
$ref->getDocComment() - 方法注释：先
$method = $ref->getMethod('store')，再$method->getDocComment() - 注意：返回的是完整字符串（含
/**和*/），需用preg_match()或docblock类库解析具体 tag
为什么 newInstanceArgs() 比 newInstance() 更常用
因为绝大多数类构造函数需要参数。直接调 newInstance() 会触发 ReflectionException: Class xxx does not have a constructor 或参数不匹配错误，而 newInstanceArgs() 允许你显式传参数组，控制力更强。
- 传空数组
[]等价于无参构造，但更明确 - 参数顺序必须和
__construct()声明一致；如果构造函数有默认值，对应位置可传null或省略（但数组索引不能断） - 若构造函数类型提示了不可实例化的接口或抽象类，这里会直接报错，不是延迟到后续调用才暴露
- 性能上没差别，但可读性和调试友好度高很多
反射获取 private 属性值的正确姿势
不能直接用 $prop->getValue($obj)，会报 Cannot access private property。必须先调 $prop->setAccessible(true) 打开访问通道。
这个开关只在当前反射对象上生效，不影响其他地方，也不改变原类定义。但要注意：PHP 8.1+ 对 setAccessible() 加了限制，如果属性被 #[\SensitiveParameter] 或类似运行时敏感标记修饰，即使设为 true 也无法读取。
- 获取属性前先检查可见性：
$prop->isPrivate()/$prop->isProtected() - 设为可访问后，才能调
getValue($obj)；设为 false 后再调会恢复报错 - 批量操作时记得循环里每个
ReflectionProperty都要单独setAccessible(true)，不能复用
实际用反射读私有属性或调私有方法，多数出现在测试桩、序列化工具或 ORM 映射层。别为了“看起来高级”在业务逻辑里滥用——可读性掉得很快，而且 IDE 几乎无法跳转或补全。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
