首页 > 代码库 > PHP反射ReflectionClass、ReflectionMethod 入门教程

PHP反射ReflectionClass、ReflectionMethod 入门教程

PHP反射ReflectionClass、ReflectionMethod 入门教程    

http://blog.snsgou.com/post-42.html

 

PHP5 具有完整的反射API,添加对类、接口、函数、方法和扩展进行反向工程的能力。

反射是什么?

它是指在PHP运行状态中,扩展分析PHP程序,导出或提取出关于类、方法、属性、参数等的详细信息,包括注释。这种动态获取的信息以及动态调用对 象的方法的功能称为反射API。反射是操纵面向对象范型中元模型的API,其功能十分强大,可帮助我们构建复杂,可扩展的应用。

其用途如:自动加载插件,自动生成文档,甚至可用来扩充PHP语言。

PHP反射api由若干类组成,可帮助我们用来访问程序的元数据或者同相关的注释交互。借助反射我们可以获取诸如类实现了那些方法,创建一个类的实例(不同于用new创建),调用一个方法(也不同于常规调用),传递参数,动态调用类的静态方法。

反射api是PHP内建的OOP技术扩展,包括一些类,异常和接口,综合使用他们可用来帮助我们分析其它类,接口,方法,属性,方法和扩展。这些OOP扩展被称为反射。

 

平常我们用的比较多的是 ReflectionClass类 和 ReflectionMethod类,例如:

01<?php
02class Person {
03 
04    /**
05     * For the sake of demonstration, we"re setting this private
06     */
07    private $_allowDynamicAttributes = false;
08 
09    /**
10     * type=primary_autoincrement
11     */
12    protected $id = 0;
13 
14    /**
15     * type=varchar length=255 null
16     */
17    protected $name;
18 
19    /**
20     * type=text null
21     */
22    protected $biography;
23 
24    public function getId() {
25        return $this->id;
26    }
27 
28    public function setId($v) {
29        $this->id = $v;
30    }
31 
32    public function getName() {
33        return $this->name;
34    }
35 
36    public function setName($v) {
37        $this->name = $v;
38    }
39 
40    public function getBiography() {
41        return $this->biography;
42    }
43 
44    public function setBiography($v) {
45        $this->biography = $v;
46    }
47}

 

一、通过ReflectionClass,我们可以得到Person类的以下信息:

  1. 常量 Contants
  2. 属性 Property Names
  3. 方法 Method Names静态
  4. 属性 Static Properties
  5. 命名空间 Namespace
  6. Person类是否为final或者abstract
  7. Person类是否有某个方法

接下来反射它,只要把类名"Person"传递给ReflectionClass就可以了:

1$class = new ReflectionClass(‘Person‘); // 建立 Person这个类的反射类 
2$instance  = $class->newInstanceArgs($args); // 相当于实例化Person 类

 

1)获取属性(Properties):

1$properties = $class->getProperties();
2foreach ($properties as $property) {
3    echo $property->getName() . "\n";
4}
5// 输出:
6// _allowDynamicAttributes
7// id
8// name
9// biography

默认情况下,ReflectionClass会获取到所有的属性,private 和 protected的也可以。如果只想获取到private属性,就要额外传个参数:

1$private_properties = $class->getProperties(ReflectionProperty::IS_PRIVATE);

可用参数列表:

  • ReflectionProperty::IS_STATIC
  • ReflectionProperty::IS_PUBLIC
  • ReflectionProperty::IS_PROTECTED
  • ReflectionProperty::IS_PRIVATE

通过$property->getName()可以得到属性名。

 

2)获取注释:

通过getDocComment可以得到写给property的注释。 

01foreach ($properties as $property) {
02    if ($property->isProtected()) {
03        $docblock = $property->getDocComment();
04        preg_match(‘/ type\=([a-z_]*) /‘, $property->getDocComment(), $matches);
05        echo $matches[1] . "\n";
06    }
07}
08// Output:
09// primary_autoincrement
10// varchar
11// text

 

3)获取类的方法

  • getMethods()       来获取到类的所有methods。
  • hasMethod(string)  是否存在某个方法
  • getMethod(string)  获取方法

 

4)执行类的方法:

1$instance->getName(); // 执行Person 里的方法getName
2// 或者:
3$method = $class->getmethod(‘getName‘);  // 获取Person 类中的getName方法
4$method->invoke($instance);              // 执行getName 方法
5// 或者:
6$method = $class->getmethod(‘setName‘);  // 获取Person 类中的setName方法
7$method->invokeArgs($instance, array(‘snsgou.com‘));

 

二、通过ReflectionMethod,我们可以得到Person类的某个方法的信息:

  1. 是否“public”、“protected”、“private” 、“static”类型
  2. 方法的参数列表
  3. 方法的参数个数
  4. 反调用类的方法
1// 执行detail方法
2$method = new ReflectionMethod(‘Person‘, ‘test‘);
3 
4if ($method->isPublic() && !$method->isStatic()) {
5    echo ‘Action is right‘;
6}
7echo $method->getNumberOfParameters(); // 参数个数
8echo $method->getParameters(); // 参数对象数组

 

 

参考:

[PHP手册] ReflectionClass类

[PHP手册] ReflectionMethod类

PHP反射ReflectionClass、ReflectionMethod 入门教程