PHP 反射机制详解 以及插件架构实现

1。用途：

该扩展分析php程序，导出或提取出关于类、方法、属性、参数等的详细信息，包括注释。

Reflection可以说是对php库函数：“Classes/Objects 类／对象函数”的一个扩展。

主要用在通过程序检测现有php程序内部关于类、方法等信息，并做出处理。

2。API概览：

class Reflection { }

interface Reflector { }

class ReflectionException extends Exception { }

class ReflectionFunction implements Reflector { }

class ReflectionParameter implements Reflector { }

class ReflectionMethod extends ReflectionFunction { }

class ReflectionClass implements Reflector { }

class ReflectionObject extends ReflectionClass { }

class ReflectionProperty implements Reflector { }

class ReflectionExtension implements Reflector { }

3。详细说明：（例子详见php手册）

①Reflection类

<?php

class Reflection

{

public static mixed export(Reflector r [,bool return])

//导出一个类或方法的详细信息

public static array getModifierNames(int modifiers)

//取得修饰符的名字

}

?>

②ReflectionException类

该类继承标准类，没特殊方法和属性。

③ReflectionFunction类

<?php

class ReflectionFunction implements Reflector

{

final private __clone()

public object __construct(string name)

public string __toString()

public static string export()

//导出该函数的详细信息

public string getName()

//取得函数名

public bool isInternal()

//测试是否为系统内部函数

public bool isUserDefined()

//测试是否为用户自定义函数

public string getFileName()

//取得文件名，包括路径名

public int getStartLine()

//取得定义函数的起始行

public int getEndLine()

//取得定义函数的结束行

public string getDocComment()

//取得函数的注释

public array getStaticVariables()

//取得静态变量

public mixed invoke(mixed* args)

//调用该函数，通过参数列表传参数

public mixed invokeArgs(array args)

//调用该函数，通过数组传参数

public bool returnsReference()

//测试该函数是否返回引用

public ReflectionParameter[] getParameters()

//取得该方法所需的参数，返回值为对象数组

public int getNumberOfParameters()

//取得该方法所需的参数个数

public int getNumberOfRequiredParameters()

//取得该方法所需的参数个数

}

?>

④ReflectionParameter类：

<?php

class ReflectionParameter implements Reflector

{

final private __clone()

public object __construct(string name)

public string __toString()

public static string export()

//导出该参数的详细信息

public string getName()

//取得参数名

public bool isPassedByReference()

//测试该参数是否通过引用传递参数

public ReflectionClass getClass()

//若该参数为对象，返回该对象的类名

public bool isArray()

//测试该参数是否为数组类型

public bool allowsNull()

//测试该参数是否允许为空

public bool isOptional()

//测试该参数是否为可选的，当有默认参数时可选

public bool isDefaultValueAvailable()

//测试该参数是否为默认参数

public mixed getDefaultValue()

//取得该参数的默认值

}

?>

⑤ReflectionClass类：

<?php

class ReflectionClass implements Reflector

{

final private __clone()

public object __construct(string name)

public string __toString()

public static string export()

//导出该类的详细信息

public string getName()

//取得类名或接口名

public bool isInternal()

//测试该类是否为系统内部类

public bool isUserDefined()

//测试该类是否为用户自定义类

public bool isInstantiable()

//测试该类是否被实例化过

public bool hasConstant(string name)

//测试该类是否有特定的常量

public bool hasMethod(string name)

//测试该类是否有特定的方法

public bool hasProperty(string name)

//测试该类是否有特定的属性

public string getFileName()

//取得定义该类的文件名，包括路径名

public int getStartLine()

//取得定义该类的开始行

public int getEndLine()

//取得定义该类的结束行

public string getDocComment()

//取得该类的注释

public ReflectionMethod getConstructor()

//取得该类的构造函数信息

public ReflectionMethod getMethod(string name)

//取得该类的某个特定的方法信息

public ReflectionMethod[] getMethods()

//取得该类的所有的方法信息

public ReflectionProperty getProperty(string name)

//取得某个特定的属性信息

public ReflectionProperty[] getProperties()

//取得该类的所有属性信息

public array getConstants()

//取得该类所有常量信息

public mixed getConstant(string name)

//取得该类特定常量信息

public ReflectionClass[] getInterfaces()

//取得接口类信息

public bool isInterface()

//测试该类是否为接口

public bool isAbstract()

//测试该类是否为抽象类

public bool isFinal()

//测试该类是否声明为final

public int getModifiers()

//取得该类的修饰符，返回值类型可能是个资源类型

//通过Reflection::getModifierNames($class->getModifiers())进一步读取

public bool isInstance(stdclass object)

//测试传入的对象是否为该类的一个实例

public stdclass newInstance(mixed* args)

//创建该类实例

public ReflectionClass getParentClass()

//取得父类

public bool isSubclassOf(ReflectionClass class)

//测试传入的类是否为该类的父类

public array getStaticProperties()

//取得该类的所有静态属性

public mixed getStaticPropertyValue(string name [, mixed default])

//取得该类的静态属性值，若private，则不可访问

public void setStaticPropertyValue(string name, mixed value)

//设置该类的静态属性值，若private，则不可访问，有悖封装原则

public array getDefaultProperties()

//取得该类的属性信息，不含静态属性

public bool isIterateable()

public bool implementsInterface(string name)

//测试是否实现了某个特定接口

public ReflectionExtension getExtension()

public string getExtensionName()

}

?>

⑥ReflectionMethod类：

<?php

class ReflectionMethod extends ReflectionFunction

{

public __construct(mixed class, string name)

public string __toString()

public static string export()

//导出该方法的信息

public mixed invoke(stdclass object, mixed* args)

//调用该方法

public mixed invokeArgs(stdclass object, array args)

//调用该方法，传多参数

public bool isFinal()

//测试该方法是否为final

public bool isAbstract()

//测试该方法是否为abstract

public bool isPublic()

//测试该方法是否为public

public bool isPrivate()

//测试该方法是否为private

public bool isProtected()

//测试该方法是否为protected

public bool isStatic()

//测试该方法是否为static

public bool isConstructor()

//测试该方法是否为构造函数

public bool isDestructor()

//测试该方法是否为析构函数

public int getModifiers()

//取得该方法的修饰符

public ReflectionClass getDeclaringClass()

//取得该方法所属的类

// Inherited from ReflectionFunction

final private __clone()

public string getName()

public bool isInternal()

public bool isUserDefined()

public string getFileName()

public int getStartLine()

public int getEndLine()

public string getDocComment()

public array getStaticVariables()

public bool returnsReference()

public ReflectionParameter[] getParameters()

public int getNumberOfParameters()

public int getNumberOfRequiredParameters()

}

?>

⑦ReflectionProperty类：

<?php

class ReflectionProperty implements Reflector

{

final private __clone()

public __construct(mixed class, string name)

public string __toString()

public static string export()

//导出该属性的详细信息

public string getName()

//取得该属性名

public bool isPublic()

//测试该属性名是否为public

public bool isPrivate()

//测试该属性名是否为private

public bool isProtected()

//测试该属性名是否为protected

public bool isStatic()

//测试该属性名是否为static

public bool isDefault()

public int getModifiers()

//取得修饰符

public mixed getValue(stdclass object)

//取得该属性值

public void setValue(stdclass object, mixed value)

//设置该属性值

public ReflectionClass getDeclaringClass()

//取得定义该属性的类

public string getDocComment()

//取得该属性的注释

}

?>

⑧ReflectionExtension类

<?php

class ReflectionExtension implements Reflector {

final private __clone()

public __construct(string name)

public string __toString()

public static string export()

//导出该扩展的所有信息

public string getName()

//取得该扩展的名字

public string getVersion()

//取得该扩展的版本

public ReflectionFunction[] getFunctions()

//取得该扩展的所有函数

public array getConstants()

//取得该扩展的所有常量

public array getINIEntries()

//取得与该扩展相关的，在php.ini中的指令信息

public ReflectionClass[] getClasses()

public array getClassNames()

}

?>

4。附：

其实从第二点API概览可以看出：接口挺好用的。

一方面Reflector接口为Reflection小系统提供了一个很好的接口命名规范，

每个实现他的类都须按他的规范，从外部看来，这个小系统API很统一。

另一方面由于很多类实现了Reflector接口，

在这样的类层次结构中，若想实现多态是很容易的。

演示用代码

如下所示：

<?php

class ClassOne {

function callClassOne() {

print "In Class One";

}

}

class ClassOneDelegator {

private $targets;

function __construct() {

$this->target[] = new ClassOne();

}

function __call($name, $args) {

foreach ($this->target as $obj) {

$r = new ReflectionClass($obj);

if ($method = $r->getMethod($name)) {

if ($method->isPublic() && !$method->isAbstract()) {

return $method->invoke($obj, $args);

}

}

}

}

}

$obj = new ClassOneDelegator();

$obj->callClassOne();

?>

输出结果：

In Class One

可见，通过
代理

类ClassOneDelegator来代替ClassOne类来实现他的方法

。

同样的，如下的代码也是能够运行的：

<?php

class ClassOne {

function callClassOne() {

print "In Class One";

}

}

class ClassOneDelegator {

private $targets;

function addObject($obj) {

$this->target[] = $obj;

}

function __call($name, $args) {

foreach ($this->target as $obj) {

$r = new ReflectionClass($obj);

if ($method = $r->getMethod($name)) {

if ($method->isPublic() && !$method->isAbstract()) {

return $method->invoke($obj, $args);

}

}

}

}

}

$obj = new ClassOneDelegator();

$obj->addObject(new ClassOne());

$obj->callClassOne();

?>

PHP
反射
API--利用反射
技术实现的插件系统架构

http://www.e897.com/Article/wlbc/php/200908/5377.html

1. /**

2. * @name PHP反射API--利用反射技术实现的插件系统架构

3. * @author :PHPCQ.COM

4. */

5. interface Iplugin{

6. public static function getName();

7. }

8. function findPlugins(){

9. $plugins = array();

10. foreach (get_declared_classes() as $class){

11. $reflectionClass = new ReflectionClass($class);

12. if ($reflectionClass->implementsInterface('Iplugin')) {

13. $plugins[] = $reflectionClass;

14. }

15. }

16. return $plugins;

17. }

18. function computeMenu(){

19. $menu = array();

20. foreach (findPlugins() as $plugin){

21. if ($plugin->hasMethod('getMenuItems')) {

22. $reflectionMethod = $plugin->getMethod('getMenuItems');

23. if ($reflectionMethod->isStatic()) {

24. $items = $reflectionMethod->invoke(null);

25. } else {

26. $pluginInstance = $plugin->newInstance();

27.
$items = $reflectionMethod->invoke($pluginInstance);

28. }

29. $menu = array_merge($menu,$items);

30. }

31. }

32. return $menu;

33. }

34. function computeArticles(){

35. $articles = array();

36. foreach (findPlugins() as $plugin){

37. if ($plugin->hasMethod('getArticles')) {

38. $reflectionMethod = $plugin->getMethod('getArticles');

39. if ($reflectionMethod->isStatic()) {

40. $items = $reflectionMethod->invoke(null);

41. } else {

42. $pluginInstance = $plugin->newInstance();

43.
$items = $reflectionMethod->invoke($pluginInstance);

44. }

45. $articles = array_merge($articles,$items);

46. }

47. }

48. return $articles;

49. }

50. require_once('plugin.php');

51. $menu = computeMenu();

52. $articles = computeArticles();

53. print_r($menu);

54. print_r($articles);

55.

56.

57. //plugin.php 代码如下

58. <?php

59. class MycoolPugin implements Iplugin {

60. public static function getName(){

61. return 'MycoolPlugin';

62. }

63. public static function getMenuItems(){

64. return array(array('description'=>'MycoolPlugin','link'=>'/MyCoolPlugin'));

65. }

66. public static function getArticles(){

67.
return array(array('path'=>'/MycoolPlugin','title'=>'This is a
really cool article','text'=>xxxxxxxxx));

68. }

69. }