PHP的反射机制允许程序在运行时检查类、方法、属性等结构，并动态操作它们。ReflectionClass是反射API中最核心的类之一，它可以加载一个类并返回其实例化信息与成员列表，从而实现动态调用。
什么是ReflectionClass
ReflectionClass是PHP内置类，位于全局命名空间。传入一个类名字符串即可创建一个反射对象，通过它能获取类的构造函数、方法、属性、接口等元数据。
动态创建实例
使用ReflectionClass的newInstance或newInstanceArgs方法，可以根据参数动态构造对象，而不需要在代码中写死new关键字。
<?php
class UserService {
private $name;
public function __construct($name) {
$this->name = $name;
}
public function hello() {
return 'hello ' . $this->name;
}
}
// 动态加载类
$ref = new ReflectionClass('UserService');
// 带参数实例化
$obj = $ref->newInstanceArgs(['tom']);
echo $obj->hello();
动态调用方法
通过getMethod获取ReflectionMethod对象，可调用公有、受保护甚至私有方法。调用私有方法前需设置setAccessible(true)。
<?php
class Demo {
private function secret() {
return 'private call';
}
}
$ref = new ReflectionClass('Demo');
$instance = $ref->newInstance();
$method = $ref->getMethod('secret');
$method->setAccessible(true); // 允许访问私有
echo $method->invoke($instance);
获取类成员信息
ReflectionClass提供多个方法列出类结构，常用于依赖注入容器或路由分发器。
- getMethods() 返回所有方法数组
- getProperties() 返回属性列表
- getInterfaces() 返回实现的接口
常见应用场景
| 场景 | 说明 |
|---|---|
| 框架容器 | 根据配置类名自动实例化并注入依赖 |
| 插件系统 | 扫描类方法并动态挂载钩子 |
| 单元测试 | 调用私有方法验证内部逻辑 |
注意事项
反射会打破封装并带来一定性能开销，不应在高频循环中滥用。生产环境调用私有成员需谨慎评估安全性。
通过上述示例可以看到，PHP的ReflectionClass让动态调用变得简单。合理使用反射，可以显著降低模块间的耦合度。
PHPReflectionClass反射机制修改时间：2026-07-27 22:54:20