PHP Reflection反射机制详解：动态获取与调用类的属性及方法

目标：在运行时获取类的结构信息并动态绑定数据

在处理通用的数据传输或ORM映射时，如果每个类都需要编写大量的`$obj->prop = value;`语句，会显得极为冗余。利用PHP反射特性，我们可以编写一套逻辑，遍历任意一个类定义的结构，并将外部数组的数据按名称匹配后注入到对象中。

第一步：准备示例类以测试反射

首先，我们构建一个包含不同类型属性（Private、Protected）且具有Getter/Setter方法的模拟类Person，用于后续演示：

class Person {
    private $_allowDynamicAttributes = false;
    protected $id = 0;
    protected $name;
    protected $biography;

    public function getId() { return $this->id; }
    public function setId($v) { $this->id = $v; }
    
    public function getName() { return $this->name; }
    public function setName($v) { $this->name = $v; }
    
    public function getBiography() { return $this->biography; }
    public function setBiography($v) { $this->biography = $v; }
}

第二步：通过ReflectionClass初始化反射对象

要将一个类纳入反射器的管理范围，最直接的方式是实例化ReflectionClass并将其作为参数传入目标类的字符串名称。这样我们就拿到了该类的底层元数据容器：

$class = new ReflectionClass('Person');

第三步：获取类的属性并解析DocBlock注释

使用getProperties()方法可以一次性抓取类定义中的所有成员变量。即便是不对外暴露的`private`和`protected`属性，也能被成功捕获。如果需要限制权限范围，可以给该方法传递过滤器参数，如ReflectionProperty::IS_PRIVATE等。以下是完整的获取及过滤属性列表的操作：

// 默认获取所有属性
$properties = $class->getProperties();
foreach($properties as $property) {
    echo $property->getName()."\n";
}
// 输出结果：
// _allowDynamicAttributes
// id
// name
// biography

为了进行更高级的应用，我们可以进一步提取写在属性上方的注释信息。例如，我们在代码中为属性添加了类似 /** type=primary_autoincrement */ 的标识，下面演示如何通过正则从DocComment中提取这些自定义字段：

foreach($properties as $property) {
    // 筛选特定的属性进行处理
    if($property->isProtected()) {
        $docblock = $property->getDocComment();
        preg_match('/ type=([a-z_]*) /', $docblock, $matches);
        if(!empty($matches[1])) {
            echo "类型标识: " . $matches[1]."\n";
        }
    }
}
// 输出结果：
// primary_autoincrement
// varchar
// text

第四步：验证并调用对象的方法（Invoke）

掌握了属性的获取方式后，核心在于如何将一组键值对数据正确地填充进上述Person对象。我们借助反射提供的getMethod定位指定函数，并使用invoke触发实际执行。

操作流程分为两部分：首先是校验数据结构是否合法（类是否存在对应的属性和方法），其次是通过反射将数据注入并回读校验。

$data = array(
    "id" => 1, 
    "name" => "Chris", 
    "biography" => "I am a PHP developer"
);

foreach($data as $key => $value) {
    // 1. 前置条件校验
    if(!$class->hasProperty($key)) {
        throw new Exception($key." is not a valid property");
    }
    if(!$class->hasMethod("set".ucfirst($key))) {
        throw new Exception($key." is missing a setter");
    }
    if(!$class->hasMethod("get".ucfirst($key))) {
        throw new Exception($key." is missing a getter");
    }
    
    // 2. 实例化交互对象
    $object = new Person();
    
    // 3. 激活Setter方法进行赋值
    $setter = $class->getMethod("set".ucfirst($key));
    $ok = $setter->invoke($object, $value);
    
    // 4. 激活Getter方法回读取值
    $getter = $class->getMethod("get".ucfirst($key));
    $objValue = $getter->invoke($object);
    
    // 5. 对比原始值与回读值
    if($value == $objValue) {
        echo "Getter or Setter has modified the data.\n";
    } else {
        echo "Getter and Setter does not modify the data.\n";
    }
}

通过以上流程，PHP不仅能静态分析代码结构，还能在运行阶段突破常规可见性限制，实现对类内部状态的探测与操控。这在开发大型框架中的通用组件（如自动加载器、依赖注入容器等）时具备极高的实用价值。

以上就是PHP Reflection反射机制的详细内容，更多关于PHP面向对象进阶的资料请关注本站其它相关文章！