PHP反射ReflectionClass、ReflectionMethod 学习笔记 （一）

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

 

反射是什么？

 

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

 

其用途如：自动加载插件，自动生成文档，甚至可用来扩充php语言。

 

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

 

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

 

 

 

平常我们用的比较多的是 reflectionclass类 和 reflectionmethod类，例如：

 

 

01    <?php

02    class 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类的以下信息：

 

常量 contants

属性 property names

方法 method names静态

属性 static properties

命名空间 namespace

person类是否为final或者abstract

person类是否有某个方法

接下来反射它，只要把类名"person"传递给reflectionclass就可以了：

 

1    $class = new reflectionclass('person'); // 建立 person这个类的反射类 

2    $instance  = $class->newinstanceargs($args); // 相当于实例化person 类

1）获取属性(properties)：

 

 

1    $properties = $class->getproperties();

2    foreach ($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的注释。 

 

 

01    foreach ($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类的某个方法的信息：

 

是否“public”、“protected”、“private” 、“static”类型

方法的参数列表

方法的参数个数

反调用类的方法

 

1    // 执行detail方法

2    $method = new reflectionmethod('person', 'test');

3     

4    if ($method->ispublic() && !$method->isstatic()) {

5        echo 'action is right';

6    }

7    echo $method->getnumberofparameters(); // 参数个数

8    echo $method->getparameters(); // 参数对象数组