当前位置:首页 > PHP教程 > php高级应用 > 列表

详解PHP的反射使用

发布:smiling 来源: PHP粉丝网  添加日期:2022-06-30 10:57:01 浏览: 评论:0 

下面我们讲下反射在实际开发中的应用。

自动生成文档

实现 MVC 架构

实现单元测试

配合 DI 容器解决依赖

自动生成文档

根据反射的分析类,接口,函数和方法的内部结构,方法和函数的参数,以及类的属性和方法,可以自动生成文档。

  1. /** 
  2.  
  3.  * 学生类 
  4.  
  5.  * 
  6.  
  7.  * 描述信息 
  8.  
  9.  */ 
  10.  
  11. class Student 
  12.  
  13.  
  14.     const NORMAL = 1; 
  15.  
  16.     const FORBIDDEN = 2; 
  17.  
  18.     /** 
  19.  
  20.      * 用户ID 
  21.  
  22.      * @var 类型 
  23.  
  24.      */ 
  25.  
  26.     public $id
  27.  
  28.     /** 
  29.  
  30.      * 获取id 
  31.  
  32.      * @return int 
  33.  
  34.      */ 
  35.  
  36.     public function getId() 
  37.  
  38.     { 
  39.  
  40.         return $this->id; 
  41.  
  42.     } 
  43.  
  44.     public function setId($id = 1) 
  45.  
  46.     { 
  47.  
  48.         $this->id = $id
  49.  
  50.     } 
  51.  
  52.  
  53. $ref = new ReflectionClass('Student'); 
  54.  
  55. $doc = $ref->getDocComment(); 
  56.  
  57. echo $ref->getName() . ':' . getComment($ref) , "\n"
  58.  
  59. echo "属性列表:\n"
  60.  
  61. printf("%-15s%-10s%-40s\n"'Name''Access''Comment'); 
  62.  
  63. $attr = $ref->getProperties(); 
  64.  
  65. foreach ($attr as $row) { 
  66.  
  67.     printf("%-15s%-10s%-40s\n"$row->getName(), getAccess($row), getComment($row)); 
  68.  
  69.  
  70. echo "常量列表:\n"
  71.  
  72. printf("%-15s%-10s\n"'Name''Value'); 
  73.  
  74. $const = $ref->getConstants(); 
  75.  
  76. foreach ($const as $key => $val) { 
  77.  
  78.     printf("%-15s%-10s\n"$key$val); 
  79.  
  80.  
  81. echo "\n\n"
  82.  
  83. echo "方法列表\n"
  84.  
  85. printf("%-15s%-10s%-30s%-40s\n"'Name''Access''Params''Comment'); 
  86.  
  87. $methods = $ref->getMethods(); 
  88.  
  89. foreach ($methods as $row) { 
  90.  
  91.     printf("%-15s%-10s%-30s%-40s\n"$row->getName(), getAccess($row), getParams($row), getComment($row)); 
  92.  
  93.  
  94. // 获取权限 
  95.  
  96. function getAccess($method
  97.  
  98.  
  99.     if ($method->isPublic()) { 
  100.  
  101.         return 'Public'
  102.  
  103.     } 
  104.  
  105.     if ($method->isProtected()) { 
  106.  
  107.         return 'Protected'
  108.  
  109.     } 
  110.  
  111.     if ($method->isPrivate()) { 
  112.  
  113.         return 'Private'
  114.  
  115.     } 
  116.  
  117.  
  118. // 获取方法参数信息 
  119.  
  120. function getParams($method
  121.  
  122.  
  123.     $str = ''
  124.  
  125.     $parameters = $method->getParameters(); 
  126.  
  127.     foreach ($parameters as $row) { 
  128.  
  129.         $str .= $row->getName() . ','
  130.  
  131.         if ($row->isDefaultValueAvailable()) { 
  132.  
  133.             $str .= "Default: {$row->getDefaultValue()}"
  134.  
  135.         } 
  136.  
  137.     } 
  138.  
  139.     return $str ? $str : ''
  140.  
  141.  
  142. // 获取注释 
  143.  
  144. function getComment($var
  145.  
  146.  
  147.     $comment = $var->getDocComment(); 
  148.  
  149.     // 简单的获取了第一行的信息,这里可以自行扩展 
  150.  
  151.     preg_match('/\* (.*) *?/'$comment$res); 
  152.  
  153.     return isset($res[1]) ? $res[1] : ''
  154.  

运行 php file.php 就可以看到相应的文档信息。

实现 MVC 架构

现在好多框架都是 MVC 的架构,根据路由信息定位 控制器($controller) 和方法($method) 的名称,之后使用反射实现自动调用。

  1. $class = new ReflectionClass(ucfirst($controller) . 'Controller'); 
  2.  
  3. $controller = $class->newInstance(); 
  4.  
  5. if ($class->hasMethod($method)) { 
  6.  
  7.     $method = $class->getMethod($method); 
  8.  
  9.     $method->invokeArgs($controller$arguments); 
  10.  
  11. else { 
  12.  
  13.     throw new Exception("{$controller} controller method {$method} not exists!"); 
  14.  

实现单元测试

一般情况下我们会对函数和类进行测试,判断其是否能够按我们预期返回结果,我们可以用反射实现一个简单通用的类测试用例。

  1. class Calc 
  2.  
  3.  
  4.     public function plus($a$b
  5.  
  6.     { 
  7.  
  8.         return $a + $b
  9.  
  10.     } 
  11.  
  12.     public function minus($a$b
  13.  
  14.     { 
  15.  
  16.         return $a - $b
  17.  
  18.     } 
  19.  
  20.  
  21. function testEqual($method$assert$data
  22.  
  23.  
  24.     $arr = explode('@'$method); 
  25.  
  26.     $class = $arr[0]; 
  27.  
  28.     $method = $arr[1]; 
  29.  
  30.     $ref = new ReflectionClass($class); 
  31.  
  32.     if ($ref->hasMethod($method)) { 
  33.  
  34.         $method = $ref->getMethod($method); 
  35.  
  36.         $res = $method->invokeArgs(new $class$data); 
  37.  
  38.         var_dump($res === $assert); 
  39.  
  40.     } 
  41.  
  42.  
  43. testEqual('Calc@plus', 3, [1, 2]); 
  44.  
  45. testEqual('Calc@minus', -1, [1, 2]); 

这是类的测试方法,也可以利用反射实现函数的测试方法。

这里只是我简单写的一个测试用例,PHPUnit 单元测试框架很大程度上依赖了 Reflection 的特性,可以了解下。

配合 DI 容器解决依赖

Laravel 等许多框架都是使用 Reflection 解决依赖注入问题,具体可查看 Laravel 源码进行分析。

下面我们代码简单实现一个 DI 容器演示 Reflection 解决依赖注入问题。

  1. class DI 
  2.  
  3.  
  4.     protected static $data = []; 
  5.  
  6.     public function __set($k$v
  7.  
  8.     { 
  9.  
  10.         self::$data[$k] = $v
  11.  
  12.     } 
  13.  
  14.     public function __get($k
  15.  
  16.     { 
  17.  
  18.         return $this->bulid(self::$data[$k]); 
  19.  
  20.     } 
  21.  
  22.     // 获取实例 
  23.  
  24.     public function bulid($className
  25.  
  26.     { 
  27.  
  28.         // 如果是匿名函数,直接执行,并返回结果 
  29.  
  30.         if ($className instanceof Closure) { 
  31.  
  32.             return $className($this); 
  33.  
  34.         } 
  35.  
  36.           
  37.  
  38.         // 已经是实例化对象的话,直接返回 
  39.  
  40.         if(is_object($className)) { 
  41.  
  42.             return $className
  43.  
  44.         } 
  45.  
  46.         // 如果是类的话,使用反射加载 
  47.  
  48.         $ref = new ReflectionClass($className); 
  49.  
  50.         // 监测类是否可实例化 
  51.  
  52.         if (!$ref->isInstantiable()) { 
  53.  
  54.             throw new Exception('class' . $className . ' not find'); 
  55.  
  56.         } 
  57.  
  58.         // 获取构造函数 
  59.  
  60.         $construtor = $ref->getConstructor(); 
  61.  
  62.         // 无构造函数,直接实例化返回 
  63.  
  64.         if (is_null($construtor)) { 
  65.  
  66.             return new $className
  67.  
  68.         } 
  69.  
  70.         // 获取构造函数参数 
  71.  
  72.         $params = $construtor->getParameters(); 
  73.  
  74.         // 解析构造函数 
  75.  
  76.         $dependencies = $this->getDependecies($params); 
  77.  
  78.         // 创建新实例 
  79.  
  80.         return $ref->newInstanceArgs($dependencies); 
  81.  
  82.     } 
  83.  
  84.     // 分析参数,如果参数中出现依赖类,递归实例化 
  85.  
  86.     public function getDependecies($params
  87.  
  88.     { 
  89.  
  90.         $data = []; 
  91.  
  92.         foreach($params as $param
  93.  
  94.         { 
  95.  
  96.             $tmp = $param->getClass(); 
  97.  
  98.             if (is_null($tmp)) { 
  99.  
  100.                 $data[] = $this->setDefault($param); 
  101.  
  102.             } else { 
  103.  
  104.                 $data[] = $this->bulid($tmp->name); 
  105.  
  106.             } 
  107.  
  108.         } 
  109.  
  110.         return $data
  111.  
  112.     } 
  113.  
  114.       
  115.  
  116.     // 设置默认值 
  117.  
  118.     public function setDefault($param
  119.  
  120.     { 
  121.  
  122.         if ($param->isDefaultValueAvailable()) { 
  123.  
  124.             return $param->getDefaultValue(); 
  125.  
  126.         } 
  127.  
  128.         throw new Exception('no default value!'); 
  129.  
  130.     } 
  131.  
  132.  
  133. class Demo 
  134.  
  135.  
  136.     public function __construct(Calc $calc
  137.  
  138.     { 
  139.  
  140.         echo $calc->plus(1, 2); 
  141.  
  142.     } 
  143.  
  144.  
  145. $di = new DI(); 
  146.  
  147. $di->calc = 'Calc'// 加载单元测试用例中 Calc 类 
  148.  
  149. $di->demo = 'Demo'
  150.  
  151. $di->demo; 

注意上面的 calc 和 demo 的顺序,不能颠倒,不然的话会报错,原因是由于 Demo 依赖 Calc,首先要定义依赖关系。

在 Demo 实例化的时候,会用到 Calc 类,也就是说 Demo 依赖于 Calc,但是在 $data 上面找不到的话,会抛出错误,所以首先要定义 $di->calc = 'Calc'。

Reflection 是一个非常 Cool 的功能,使用它,但不要滥用它。

End

Tags: PHP反射使用

分享到: