PHP 反射 API 是 PHP 内置的一套用于 “反向解析” 代码结构的工具集，简单来说，它能让程序在运行时 “看透” 类、方法、函数、参数、注解等代码元素的所有细节，甚至能动态调用方法、修改属性访问权限 —— 就像给代码做 “CT 扫描”，精准获取其内部结构和特性，是框架开发、自动化工具构建的核心技术。
一、核心定位：运行时解析代码的 “透视镜”
PHP 是动态脚本语言，但常规开发中，我们只能按既定逻辑调用类 / 方法，无法直接获取 “某个类有哪些私有方法”“某个方法的参数类型是什么” 这类元信息。而反射 API 打破了这个限制，它能在程序运行过程中，动态获取代码的结构信息，还能对其进行操作，是实现 “动态编程” 的关键。
二、核心功能（通俗易懂版）
精准解析代码结构
- 解析类：获取类名、父类、实现的接口、命名空间、所有属性（公有 / 私有 / 受保护）、所有方法（含参数列表、返回值类型、注解）；
- 解析函数 / 方法：获取参数名称、类型、默认值、是否可选，以及方法的访问修饰符（public/private/protected）；
- 解析注解：配合注释解析，提取类 / 方法上的自定义注解（如
@RequestMapping），是框架实现路由、依赖注入的核心。
动态操作代码元素
- 调用方法：即使是私有方法，也能通过反射强制调用；
- 修改属性：突破访问权限，读取 / 修改类的私有属性；
- 实例化类：无需
new关键字，动态创建类的实例（如根据配置字符串实例化对应类）。
场景化工具能力
- 自动生成文档：解析类 / 方法的注释和结构，自动生成 API 文档；
- 依赖注入：框架（如 Laravel/Symfony）通过反射解析类的构造函数参数，自动注入依赖对象；
- 路由匹配：解析控制器类的方法注解，匹配 URL 与处理方法的映射关系。
三、常用核心类
| 类名 | 作用 |
|---|---|
ReflectionClass | 解析类的所有信息 |
ReflectionMethod | 解析方法的所有信息 |
ReflectionProperty | 解析属性的所有信息 |
ReflectionParameter | 解析方法参数的所有信息 |
ReflectionFunction | 解析普通函数的所有信息 |
四、典型应用场景
- 框架开发：Laravel、ThinkPHP 等框架的 IOC 容器、路由解析、中间件、注解路由都基于反射实现；
- 自动化测试：单元测试框架通过反射调用私有方法，验证内部逻辑；
- 代码生成工具：自动生成模型类、控制器模板，或生成数据库表对应的 CURD 方法；
- 插件化开发：动态加载插件类，解析其功能并集成到主程序。
五、使用注意事项
- 性能损耗：反射会解析代码结构，比直接调用类 / 方法稍慢，高频场景需缓存解析结果；
- 破坏封装：可强制操作私有元素，滥用会导致代码耦合度升高，需谨慎使用；
- 版本兼容：部分特性（如返回值类型解析）仅支持 PHP7+，需注意版本适配。
简单示例（快速理解）
php
运行
class User { private $name = "test"; private function sayHello($msg) { return "Hello: " . $msg; } } // 1. 反射类 $refClass = new ReflectionClass(User::class); // 2. 获取私有方法 $refMethod = $refClass->getMethod('sayHello'); // 3. 突破权限调用 $refMethod->setAccessible(true); // 4. 实例化类并调用方法 $user = $refClass->newInstance(); echo $refMethod->invoke($user, "PHP反射"); // 输出：Hello: PHP反射 // 获取私有属性 $refProp = $refClass->getProperty('name'); $refProp->setAccessible(true); echo $refProp->getValue($user); // 输出：test
