PHP7.2怎样使用ReflectionClass获取方法

说到PHP的反射机制，`ReflectionClass`绝对是绕不开的核心工具之一。尤其是在PHP 7.2这个版本里，它已经相当成熟，但也埋着一些让人踩坑的细节。今天就来聊聊，怎么用好它来获取方法、参数和返回类型的信息。 先看一个基础用法：`getMethods()` 和 `getMethod()`。前者帮你拿到类里所有的方法，后者则精准定位到某一个具体方法。但别小看这两个函数，用不好，代码里可能就多了几个莫名其妙的bug。 ## ReflectionClass 怎么获取类的所有方法 说白了，就是直接用 `getMethods()` 一把梭，拿到一个 `ReflectionMethod` 数组。但默认情况下，它会把所有可见性的方法都翻出来——public、protected、private，一个不落。如果你只想看公开的，得手动传个参数进去。 - `getMethods()` 不加参数，返回全部方法，包括private和protected - `getMethods(ReflectionMethod::IS_PUBLIC)`，只返回public方法 - 想筛出静态方法？用 `ReflectionMethod::IS_STATIC` 组合一下：`getMethods(ReflectionMethod::IS_PUBLIC | ReflectionMethod::IS_STATIC)`，就能拿到public且静态的方法 - 注意一个细节：`getMethods()` 不会递归到父类，只查当前类定义的方法。要包含继承来的，得自己手动遍历父类链 ## 怎样获取某个特定方法的 ReflectionMethod 实例 `getMethod($name)` 比 `getMethods()` 更精准，也更快——尤其当你只关心一个方法的时候。传方法名字符串进去就行。 但有几个坑必须提一下： - 如果方法不存在，它不会返回false或null，直接抛出 `ReflectionException`。所以记得用try/catch兜住 - 方法名区分大小写：`getMethod('Foo')` 和 `getMethod('foo')` 是两回事 - 静态方法、构造函数（`__construct`）、析构函数（`__destruct`），都能通过这个名字获取到 - 如果只是想检查方法是否存在，不如先用 `method_exists($class, $name)` 快速判断，再决定是否走反射。这样更轻量 ## 获取方法签名和参数信息的实际用法 拿到 `ReflectionMethod` 对象后，最常用的就是 `getParameters()` 和 `getReturnType()`。PHP 7.2 已经支持返回类型反射了，但有个小问题：如果返回类型声明了 `void`，`getReturnType()` 返回的是 `null`，而不是一个 `ReflectionNamedType` 对象。 - `getParameters()` 返回 `ReflectionParameter` 数组，每个元素可以调用 `getName()`、`getType()`（返回 `ReflectionNamedType` 或 `null`）、`isOptional()` - 在PHP 7.2中，`getType()` 对联合类型（比如 `string|int`）不识别，只认单类型声明。没声明类型时返回 `null` - `getReturnType()` 在无返回类型声明时也返回 `null`。如果声明了 `self` 或 `parent`，返回的是 `ReflectionNamedType`，但它的 `getName()` 只会返回字符串 `"self"`，而不是实际的类名 - 千万别依赖 `getDocComment()` 去解析PHPDoc里的类型声明——PHP 7.2的反射不解析注释，那是第三方库（比如phpdocumentor/type-resolver）的活儿 ## 常见报错和兼容性注意点 PHP 7.2的`ReflectionClass`行为和后续版本有一些细微差异，尤其是在类型反射和魔术方法处理上。几个高频坑位： - `ReflectionException: Class xxx does not exist`：说明传给 `new ReflectionClass()` 的类名没被autoload进来，或者拼写错了。先确认 `class_exists($class)` 返回true - `ReflectionException: Method xxx::yyy() does not exist`：方法名写错了、大小写不对、或者方法是动态生成的（比如通过 `__call`），反射拿不到 - 匿名类不能用 `ReflectionClass` 构造：传入匿名类实例的 `get_class($obj)` 得到的是类似 `"class@anonymous/path/to/file.php0x12345678"` 的名字，直接 `new ReflectionClass` 会失败 - PHP 7.2不支持 `getAttributes()`（PHP 8+才有），别在代码里误用 最后说一句：反射是有开销的，别在高频循环里反复 `new ReflectionClass`。如果真需要多次查同一个类，缓存实例更稳妥。