反射机制简介

在面向对象编程中，对象被系统赋予了自省的能力，而实现这个自省的过程就是反射。
反射，简单理解就是根据目标物，得到目标物所携带的属性、技能等。在PHP中，我们可以通过反射对象，提取关于类、方法、属性、参数、注释等的详细信息。这种动态获取信息以及动态调用对象方法的功能称为反射API。
反射是操纵面向对象范型中元模型的API，其功能十分强大，可帮助我们构建复杂，可扩展的应用。比如：自动加载插件，自动生成文档，甚至可用来扩充PHP语言。
通过ReflectionClass，我们可以得到某个类的如下信息：

  1. 常量 Contants
  2. 属性 Property
  3. 方法 Method
  4. 属性 Static Properties
  5. 命名空间 Namespace
  6. 类的修饰，是否为final或者abstract

    使用

假设我们现在有一个这样的类：

  1. <?php
  3. class Student
  4. {
  5.     public $name;
  6.     protected $age;
  7.     private $sex;
  9.     public function __construct($name, $age, $sex)
  10.     {
  11.         $this->setName($name);
  12.         $this->setAge($age);
  13.         $this->setSex($sex);
  14.     }
  16.     public function setName($name)
  17.     {
  18.         $this->name = $name;
  19.     }
  21.     protected function setAge($age)
  22.     {
  23.         $this->age = $age;
  24.     }
  26.     private function setSex($sex)
  27.     {
  28.         $this->sex = $sex;
  29.     }
  30. }

调用反射导出接口

  1. <?php
  3. \ReflectionClass::export(Student::class);

获取对象属性列表

  1. <?php
  3. $student = new Student('woodylan', 18, 1);
  4. $reflect = new ReflectionObject($student);
  5. $props = $reflect->getProperties();
  6. foreach ($props as $prop) {
  7.     print $prop->getName() . "\n";
  8. }

获取对象方法列表

  1. <?php
  3. $methods = $reflect->getMethods();
  4. foreach ($methods as $prop) {
  5.     print $prop->getName() . "\n";
  6. }

反射获取类的原型

  1. <?php
  3. $reflection = new ReflectionClass(Student::class);
  4. $className = $reflection->getName();
  5. $methods = [];
  6. $properties = [];
  8. foreach ($reflection->getProperties() as $value) {
  9.     $properties[$value->getName()] = $value;
  10. }
  12. foreach ($reflection->getMethods() as $value) {
  13.     $methods[$value->getName()] = $value;
  14. }
  16. echo "class {$className}\n{\n";
  17. is_array($properties) && ksort($properties);
  18. foreach ($properties as $key => $value) {
  19.     echo "\t";
  20.     echo $value->isPublic() ? ' public' : '', $value->isPrivate() ? ' private' : '',
  21.     $value->isProtected() ? ' protected' : '',
  22.     $value->isStatic() ? ' static' : '';
  23.     echo "\t{$key}\n";
  24. }
  25. echo "\n";
  26. if (is_array($methods)) ksort($methods);
  27. foreach ($methods as $key => $value) {
  28.     echo "\tfunction {$key}(){}\n";
  29. }
  30. echo "}\n";

其它API

反射不仅可以用于类和对象，还可以用于函数、扩展模块、异常等，官方提供了一系列的API方法，以下列举部分。
文档地址：http://php.net/manual/zh/book.reflection.php

ReflectionClass::__construct — 初始化 ReflectionClass 类

ReflectionClass::export — 导出一个类

ReflectionClass::getConstant — 获取定义过的一个常量

ReflectionClass::getConstants — 获取一组常量

ReflectionClass::getConstructor — 获取类的构造函数

ReflectionClass::getDefaultProperties — 获取默认属性

ReflectionClass::getDocComment — 获取文档注释

ReflectionClass::getEndLine — 获取最后一行的行数

ReflectionClass::getExtension — 根据已定义的类获取所在扩展的 ReflectionExtension 对象

ReflectionClass::getExtensionName — 获取定义的类所在的扩展的名称

ReflectionClass::getFileName — 获取定义类的文件名

ReflectionClass::getInterfaceNames — 获取接口（interface）名称

ReflectionClass::getInterfaces — 获取接口

ReflectionClass::getMethod — 获取一个类方法的 ReflectionMethod。

ReflectionClass::getMethods — 获取方法的数组

ReflectionClass::getModifiers — 获取类的修饰符

ReflectionClass::getName — 获取类名

ReflectionClass::getNamespaceName — 获取命名空间的名称

ReflectionClass::getParentClass — 获取父类

ReflectionClass::getProperties — 获取一组属性

ReflectionClass::getProperty — 获取类的一个属性的 ReflectionProperty

ReflectionClass::getReflectionConstant — Gets a ReflectionClassConstant for a class’s constant

ReflectionClass::getReflectionConstants — Gets class constants

ReflectionClass::getShortName — 获取短名

ReflectionClass::getStartLine — 获取起始行号

ReflectionClass::getStaticProperties — 获取静态（static）属性

ReflectionClass::getStaticPropertyValue — 获取静态（static）属性的值

ReflectionClass::getTraitAliases — 返回 trait 别名的一个数组

ReflectionClass::getTraitNames — 返回这个类所使用 traits 的名称的数组

ReflectionClass::getTraits — 返回这个类所使用的 traits 数组

ReflectionClass::hasConstant — 检查常量是否已经定义

ReflectionClass::hasMethod — 检查方法是否已定义

ReflectionClass::hasProperty — 检查属性是否已定义

ReflectionClass::implementsInterface — 接口的实现

ReflectionClass::inNamespace — 检查是否位于命名空间中

ReflectionClass::isAbstract — 检查类是否是抽象类（abstract）

ReflectionClass::isAnonymous — 检查类是否是匿名类

ReflectionClass::isCloneable — 返回了一个类是否可复制

ReflectionClass::isFinal — 检查类是否声明为 final

ReflectionClass::isInstance — 检查类的实例

ReflectionClass::isInstantiable — 检查类是否可实例化

ReflectionClass::isInterface — 检查类是否是一个接口（interface）

ReflectionClass::isInternal — 检查类是否由扩展或核心在内部定义

ReflectionClass::isIterable — Check whether this class is iterable

ReflectionClass::isIterateable — 检查是否可迭代（iterateable）

ReflectionClass::isSubclassOf — 检查是否为一个子类

ReflectionClass::isTrait — 返回了是否为一个 trait

ReflectionClass::isUserDefined — 检查是否由用户定义的

ReflectionClass::newInstance — 从指定的参数创建一个新的类实例

ReflectionClass::newInstanceArgs — 从给出的参数创建一个新的类实例。

ReflectionClass::newInstanceWithoutConstructor — 创建一个新的类实例而不调用它的构造函数

ReflectionClass::setStaticPropertyValue — 设置静态属性的值

ReflectionClass::__toString — 返回 ReflectionClass 对象字符串的表示形式。