反射（Reflection）—— PHP 的“元编程之眼”

一、用一个比喻理解反射

想象你收到一个密封的乐高盒子，盒子上只写了名字：OrderController。

没有反射（传统方式）：

你只能提前知道这个盒子里面需要哪些零件（比如：一个数据库零件、一个日志零件），然后你手动去仓库找这些零件，再拼起来。

$db = new Database();           // 手动找数据库零件
$logger = new Logger();         // 手动找日志零件
$controller = new OrderController($db, $logger); // 手动拼装

问题：每次换一个盒子，你都要重新查说明书，很麻烦！

有了反射（神奇能力）：

你拥有一台智能扫描仪！
你把乐高盒子放上去，扫描仪自动告诉你：

然后你就可以自动去找这两个零件，再自动拼装！

这个“智能扫描仪”，就是反射！

二、反射到底是什么？（人话版）

它能告诉你：

• 这个类叫什么名字？
• 它有没有构造函数（__construct）？
• 构造函数需要哪些参数？
• 每个参数是什么类型？（比如是 Database 还是 string？）
• 有没有默认值？

这些信息，在代码运行之前你是不知道的，但反射能在运行时动态获取！

三、反射怎么用？（只讲最常用的3个）

你不需要记住所有方法，容器里主要就用这3个：

1️⃣ new ReflectionClass(类名)

$reflect = new ReflectionClass(\'OrderController\');
// 现在我可以问它各种问题了！

2️⃣ $reflect->getConstructor()

$constructor = $reflect->getConstructor();
// 如果有构造函数，就继续问细节

3️⃣ $constructor->getParameters()

$parameters = $constructor->getParameters();

foreach ($parameters as $param) {
    echo \"需要一个：\";
    echo $param->getType()?->getName(); // 比如 \"Database\"
}

️ 四、反射 + 容器 = 自动拼装工厂

现在把反射放进容器里，看它是怎么工作的：

// 用户只要说：我要 OrderController
$controller = Container::make(\'OrderController\');

// 容器内部：
function make($className) {
    // 1️⃣ 用反射扫描这个类
    $reflect = new ReflectionClass($className);
    
    // 2️⃣ 看它构造函数要什么
    $constructor = $reflect->getConstructor();
    
    // 3️⃣ 如果要东西，就递归去拿
    $args = [];
    foreach ($constructor->getParameters() as $param) {
        $type = $param->getType()?->getName(); // 比如 \"Database\"
        $args[] = $this->make($type); // 再去自动创建 Database！
    }
    
    // 4️⃣ 拼装完成！
    return $reflect->newInstanceArgs($args);
}

结果：你只写了一行代码，容器自动帮你创建了整个依赖链！

五、举个完整例子（超简单）

假设你有这些类：

class Database {
    public function __construct() {}
}

class OrderService {
    public function __construct(Database $db) {}
}

class OrderController {
    public function __construct(OrderService $service) {}
}

传统写法（手动拼）：

$db = new Database();
$service = new OrderService($db);
$controller = new OrderController($service);

用反射的容器写法（自动拼）：

$controller = Container::make(\'OrderController\');
// 容器自动做了上面3行的事！

反射就是那个“自动看说明书+找零件”的过程！

六、常见疑问解答

Q：反射是不是很高级？我需要学很多吗？

A：不用！ 你只要记住：

• ReflectionClass → 扫描类
• getConstructor() → 看构造函数
• getParameters() → 看需要什么参数

这3个就够了！其他都是锦上添花。

Q：没有反射，容器能工作吗？

A：不能！
没有反射，容器就像盲人摸象——它不知道一个类需要什么依赖，只能靠你手动告诉它（那就不是自动了）。

Q：反射慢吗？

A：确实比直接 new 慢一点点，但现代框架都会缓存反射结果，所以实际影响很小。为了“自动装配”的便利，这点代价完全值得！

七、一句话总结

你不需要“记住”所有反射方法，只要理解它的作用：让容器能自动看懂类的构造需求。