PHP Reflection反射机制详解与代码示例

结果与目标

在 PHP 中，Reflection（反射）允许程序在运行时检查类、接口、方法和属性的信息。本文的目标是通过 ReflectionClass 类，对一个包含多个私有属性和公有方法的测试类进行内部结构的探查，包括：
- 动态实例化对象
- 获取所有成员变量及其 DocComment
- 过滤并执行特定的 Get/Set 方法

准备条件：定义被反射的类

首先，我们需要创建一个包含各种访问级别属性和方法的类 ReflectTest.php。该类模拟了一个用户实体，定义了如 ID、用户名、密码等私有字段，并为每个字段提供了对应的 Getter/Setter 方法。

<?php
class ReflectTest {
    private $userId;
    private $userName;
    private $password;
    private $email;
    private $qq;
    private $loginTimes;

    public function __construct($userId,$userName,$password){
        $this->userId = $userId;
        $this->userName = $userName;
        $this->password = $password;
    }

    // 省略 getter 和 setter 的定义...
}

第1步：创建测试入口与基础实例化

• 目的：正常创建对象以对比普通用法与反射用法的区别。
• 动作：引入类文件并直接实例化。

<?php
require_once 'ReflectTest.php';
$ref = new ReflectTest("1", "admin", "admin888");
echo "UserId:".$ref->getUserId();
?

第2步：加载反射类并获取元数据

• 目的：使用 new ReflectionClass() 获取类的镜像，进而提取属性列表和注释信息。
• 动作：
  1. 实例化 $class = new ReflectionClass('ReflectTest')。
  2. 调用 $class->getProperties() 获取所有属性数组。
  3. 遍历数组，使用 $f->getName() 获取属性名，使用 $f->getDocComment() 获取其上方的 PHPDoc 注释。

<?php
$class = new ReflectionClass('ReflectTest');
$field = $class->getProperties();
foreach($field as $f) {
    echo $f->getName()."<br/>"; // 输出属性名
    echo $f->getDocComment();   // 输出文档注释
}

第3步：动态实例化与反射注入

• 目的：利用反射机制在不修改构造函数签名的前提下完成实例化。
• 动作：使用 $class->newInstanceArgs(array(...)) 将参数数组传递给构造函数。

<?php
$instance = $class->newInstanceArgs(array('123','root','123456'));

第4步：遍历方法并动态调用

• 目的：获取所有公开方法，并根据命名规则（如 get 开头）或特定名称（如 setQq）进行动态调用。
• 参数：$m->invoke($instance) 用于无参调用，$m->invoke($instance, 'value') 用于带参调用。

<?php
$method = $class->getMethods();
foreach($method as $m) {
    // 过滤 get 方法
    if(strpos($m->getName(), 'get') === 0) {
        echo $m->invoke($instance);
    }
    // 特殊调用 setQq
    if($m->getName() == 'setQq') {
        $m->invoke($instance, '441637262');
    }
}

第5步：验证最终结果

• 目的：确认通过反射设置和获取的值是否生效。
• 动作：调用最终的 Getter 方法输出 QQ 号。

<?php
$qqMethod = $class->getMethod('getQq');
echo $qqMethod->invoke($instance); // 输出: 441637262
?

完成判断

当控制台打印出预期的属性列表、正确的 DocComment 文本以及通过动态反射成功获取到经过 setQq 设置的值时，即代表反射机制应用成功。

简要总结

PHP 的 Reflection API 极大地增强了框架的动态性，虽然原生代码不常显式调用，但在依赖注入容器、ORM 映射及自动路由生成中至关重要。掌握 ReflectionClass 的操作是进阶 PHP 开发的必备技能。以上就是PHP Reflection反射机制详解与代码示例的详细内容，更多关于PHP开发技巧的资料请关注本站其它相关文章！