PHP 反射（Reflection） ‌是PHP面向对象编程（OOP）中一个非常强大但常被忽视的特性。它允许程序在‌运行时（Runtime）‌“反查”自身的结构信息，甚至修改类的行为。

简单来说，通常我们是‌写代码去操作对象‌；而反射是‌让代码去阅读和分析代码本身‌。

1. 核心概念：什么是反射？

想象你有一个黑盒子（一个 PHP 类）。

‌普通方式‌：你只能调用盒子上公开的按钮（Public 方法）。
‌反射方式‌：你拥有一台 X 光机，可以透视盒子内部，看到：
- 这个类叫什么？继承自谁？实现了哪些接口？
- 它有哪些属性？是 public、private 还是 protected？
- 它有哪些方法？参数是什么类型？有没有默认值？
- 它的注释（DocBlock）里写了什么？（这是 Hyperf/Laravel 注解功能的基础）

2. PHP 反射的主要类

PHP 提供了一组以 Reflection 开头的类，用于映射代码的不同部分：

类名	描述
ReflectionClass	获取类的完整信息（最常用）
ReflectionMethod	获取单个方法的详细信息
ReflectionProperty	获取单个属性的详细信息
ReflectionParameter	获取单个参数的详细信息
ReflectionFunction	获取函数的详细信息（与类方法类似，但不属于对象）
ReflectionExtension	获取扩展的详细信息

3. 实战演示：反射能做什么？

假设我们有以下类：

/**
 * 用户服务类
 * @Service
 */
class UserService {
    private string $name = "Admin";

    public function __construct(private Database $db) {
    }

    /**
     * 获取用户
     * @param int $id
     * @return array
     */
    public function getUser(int $id): array {
        return ['id' => $id];
    }

    private function secretMethod() {
        echo "这是私有方法";
    }
}

A. 获取类的基本信息

$refClass = new ReflectionClass(UserService::class);

echo $refClass->getName();       // UserService
echo $refClass->isInstantiable(); // true (是否可以被 new)
echo $refClass->isAbstract();    // false
print_r($refClass->getMethods()); // 获取所有方法列表

B. 分析构造函数（DI 容器的核心！）

这是框架实现‌自动依赖注入‌的关键步骤：

$refClass = new ReflectionClass(UserService::class);
$constructor = $refClass->getConstructor();

if ($constructor) {
    $params = $constructor->getParameters();

    foreach ($params as $param) {
        echo "参数名: " . $param->getName() . "\n"; // db

        // 获取类型提示
        $type = $param->getType();
        if ($type && !$type->isBuiltin()) {
            echo "依赖类: " . $type->getName() . "\n"; // Database
            // 框架看到这里，就知道需要去容器里找一个 Database 实例
        }
    }
}

C. 读取注释/注解（Hyperf 的核心！）

Hyperf 的 @Inject, @Controller 等注解本质上是写在 DocBlock 里的字符串。反射可以读取它们：

$refClass = new ReflectionClass(UserService::class);
$method = $refClass->getMethod('getUser');
$docComment = $method->getDocComment();

echo $docComment;
/* 输出:
/**
 * 获取用户
 * @param int $id
 * @return array
 */
*/

// Hyperf 会解析这段字符串，提取出 @param 等信息

D. 暴力访问私有成员（高级 Hack）

反射可以绕过 visibility（可见性）限制，访问或修改 private 属性和方法。这在‌单元测试‌或‌底层框架开发‌中非常有用：

$obj = new UserService(new Database());

// 1. 获取私有属性
$prop = $refClass->getProperty('name');
$prop->setAccessible(true); // 强制允许访问

echo $prop->getValue($obj); // 输出: Admin

// 2. 修改私有属性
$prop->setValue($obj, "Hacker");
echo $prop->getValue($obj); // 输出: Hacker

// 3. 调用私有方法
$method = $refClass->getMethod('secretMethod');
$method->setAccessible(true);
$method->invoke($obj); // 输出: 这是私有方法

4. 为什么反射对现代 PHP 框架至关重要？

‌自动依赖注入（Autowiring）‌：

没有反射，框架就无法知道 UserController 的构造函数需要 UserService。反射让框架能够“看懂”你的代码结构，从而自动 new 出正确的对象并传递进去。
‌注解驱动（Annotation Driven）‌：

Hyperf、Laravel、Symfony 都大量使用注解（或 PHP 8 Attributes）。反射是唯一能在运行时读取这些元数据的方式，从而实现路由注册、缓存切面、事务管理等功能。
ORM 映射‌：

像 Doctrine 或 Eloquent 这样的 ORM，通过反射读取实体类的属性，自动将其映射到数据库表的字段。
‌调试与文档生成‌：

工具如 phpDocumentor 或 IDE 的智能提示，底层都依赖反射来分析代码结构。

5. 反射的缺点：性能

虽然反射很强大，但它‌慢‌。

‌原因‌：反射需要解析类的元数据，涉及大量的内存分配和 CPU 计算。直接 new ClassName() 比 new ReflectionClass('ClassName') 快得多。
‌对比‌：在一次请求中频繁使用反射会导致显著的性能下降。

Hyperf 如何解决这个问题？‌

Hyperf 是‌常驻内存‌框架，它采用了‌“启动时扫描 + 代理类缓存”‌的策略：

‌启动阶段‌：Hyperf 使用反射扫描所有类，构建元数据。
‌生成代理‌：它将反射分析的结果编译成普通的 PHP 代码（代理类），保存在 runtime/container/proxy/ 目录下。
‌运行阶段‌：当请求到来时，框架直接加载这些已经生成好的代理类，‌不再频繁使用反射‌。

这就是为什么 Hyperf 在高并发下依然能保持高性能的原因：‌用启动时的时间换取运行时的速度。‌

总结

‌反射‌是 PHP 的“ introspection（内省）”能力。
它让框架能‌读取代码结构‌和‌注解‌。
它是‌依赖注入‌、‌AOP‌、‌ORM 的技术基础。
它‌慢‌，但 Hyperf/Laravel 通过‌缓存和预编译‌解决了性能问题。

理解反射，你就理解了现代 PHP 框架一半的秘密。

php的reflection