PHP5 具有完整的反射API,添加对类、接口、函数、方法和扩展进行反向工程的能力。
反射是什么?
它是指在PHP运行状态中,扩展分析PHP程序,导出或提取出关于类、方法、属性、参数等的详细信息,包括注释。这种动态获取的信息以及动态调用对象的方法的功能称为反射API。反射是操纵面向对象范型中元模型的API,其功能十分强大,可帮助我们构建复杂,可扩展的应用。
其用途如:自动加载插件,自动生成文档,甚至可用来扩充PHP语言。
PHP反射api由若干类组成,可帮助我们用来访问程序的元数据或者同相关的注释交互。借助反射我们可以获取诸如类实现了那些方法,创建一个类的实例(不同于用new创建),调用一个方法(也不同于常规调用),传递参数,动态调用类的静态方法。
反射api是PHP内建的OOP技术扩展,包括一些类,异常和接口,综合使用他们可用来帮助我们分析其它类,接口,方法,属性,方法和扩展。这些OOP扩展被称为反射。
平常我们用的比较多的是 ReflectionClass类 和 ReflectionMethod类,例如:
07 | private $_allowDynamicAttributes = false; |
24 | public function getId() { |
28 | public function setId( $v ) { |
32 | public function getName() { |
36 | public function setName( $v ) { |
40 | public function getBiography() { |
41 | return $this ->biography; |
44 | public function setBiography( $v ) { |
45 | $this ->biography = $v ; |
一、通过ReflectionClass,我们可以得到Person类的以下信息:
- 常量 Contants
- 属性 Property Names
- 方法 Method Names静态
- 属性 Static Properties
- 命名空间 Namespace
- Person类是否为final或者abstract
- Person类是否有某个方法
接下来反射它,只要把类名"Person"传递给ReflectionClass就可以了:
1 | $class = new ReflectionClass( ‘Person‘ ); |
2 | $instance = $class ->newInstanceArgs( $args ); |
1)获取属性(Properties):
1 | $properties = $class ->getProperties(); |
2 | foreach ( $properties as $property ) { |
3 | echo $property ->getName() . "\n" ; |
默认情况下,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" ; |
3)获取类的方法
- getMethods() 来获取到类的所有methods。
- hasMethod(string) 是否存在某个方法
- getMethod(string) 获取方法
4)执行类的方法:
3 | $method = $class ->getmethod( ‘getName‘ ); |
4 | $method ->invoke( $instance ); |
6 | $method = $class ->getmethod( ‘setName‘ ); |
7 | $method ->invokeArgs( $instance , array ( ‘snsgou.com‘ )); |
二、通过ReflectionMethod,我们可以得到Person类的某个方法的信息:
- 是否“public”、“protected”、“private” 、“static”类型
- 方法的参数列表
- 方法的参数个数
- 反调用类的方法
2 | $method = new ReflectionMethod( ‘Person‘ , ‘test‘ ); |
4 | if ( $method ->isPublic() && ! $method ->isStatic()) { |
5 | echo ‘Action is right‘ ; |
7 | echo $method ->getNumberOfParameters(); |
8 | echo $method ->getParameters(); |
参考:
[PHP手册] ReflectionClass类
[PHP手册] ReflectionMethod类
实践中的2处应用:
1、利用PHP的debug_backtrace函数,实现PHP文件权限管理、动态加载
2、PHP反射(ReflectionClass、ReflectionMethod)在ThinkPHP框架的控制器调度模块中的应用