PHP的反射類別ReflectionClass、ReflectionMethod使用實例

PHP5 具有完整的反射API，增加對類別、介面、函數、方法和擴充進行反向工程的能力。

反射是什麼？

它是指在PHP運行狀態中，擴展分析PHP程序，導出或提取出關於類、方法、屬性、參數等的詳細信息，包括註釋。這種動態取得的資訊以及動態呼叫物件的方法的功能稱為反射API。反射是操縱物件導向範式中元模型的API，其功能十分強大，可幫助我們建立複雜，可擴展的應用。

其用途如：自動載入插件，自動產生文檔，甚至可用來擴充PHP語言。

PHP反射api由若干類別組成，可協助我們用來存取程式的元資料或同相關的註解互動。借助反射我們可以取得諸如類別實作了那些方法，創建一個類別的實例（不同於用new創建），呼叫一個方法（也不同於常規呼叫），傳遞參數，動態呼叫類別的靜態方法。
反射api是PHP內建的OOP技術擴展，包括一些類，異常和接口，綜合使用他們可用來幫助我們分析其它類，接口，方法，屬性，方法和擴展。這些OOP擴展稱為反射。

平常我們用的比較多的是ReflectionClass類和ReflectionMethod類，例如：

<?php
class Person {
 /**
  * For the sake of demonstration, we"re setting this private
  */
 private $_allowDynamicAttributes = false;
 /**
  * type=primary_autoincrement
  */
 protected $id = 0;
 /**
  * type=varchar length=255 null
  */
 protected $name;
 /**
  * type=text null
  */
 protected $biography;
 public function getId() {
  return $this->id;
 }
 public function setId($v) {
  $this->id = $v;
 }
 public function getName() {
  return $this->name;
 }
 public function setName($v) {
  $this->name = $v;
 }
 public function getBiography() {
  return $this->biography;
 }
 public function setBiography($v) {
  $this->biography = $v;
 }
}

一、透過ReflectionClass，我們可以得到Person類的以下資訊：

1.常量Contants
2.屬性 Names3.方法Method Names靜態
4.屬性Static Properties
5.命名空間Namespace
6.Person類別是否為final或abstract
7.Person類別是否有某個方法

接下來反射它，只要把類別名稱"Person"傳遞給ReflectionClass就可以了：

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

1）取得屬性(Properties)：

$properties = $class->getProperties();
foreach ($properties as $property) {
 echo $property->getName() . "\n";
}
// 输出:
// _allowDynamicAttributes
// id
// name
// biography

預設情況下，ReflectionClass會取得所有的屬性，private 和protected的也可以。如果只想取得到private屬性，就要額外傳個參數：

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

可用參數清單：

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

透過$property->getName()可以得到屬性名稱。

2）取得註解：

透過getDocComment可以得到寫給property的註解。

foreach ($properties as $property) {
 if ($property->isProtected()) {
  $docblock = $property->getDocComment();
  preg_match('/ type\=([a-z_]*) /', $property->getDocComment(), $matches);
  echo $matches[1] . "\n";
 }
}
// Output:
// primary_autoincrement
// varchar
// text

3）取得類別的方法

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

4）執行類別的方法：

$instance->getName(); // 执行Person 里的方法getName
// 或者：
$method = $class->getmethod('getName'); // 获取Person 类中的getName方法
$method->invoke($instance);    // 执行getName 方法
// 或者：
$method = $class->getmethod('setName'); // 获取Person 类中的setName方法
$method->invokeArgs($instance, array('snsgou.com'));

二、透過ReflectionMethod，我們可以得到Person類別的某個方法的資訊：

1.是否「publicted」、「protected ”、“private” 、“static”類型

2.方法的參數列表
3.方法的參數個數
4.反調用類別的方法

// 执行detail方法
$method = new ReflectionMethod('Person', 'test');
if ($method->isPublic() && !$method->isStatic()) {
 echo 'Action is right';
}
echo $method->getNumberOfParameters(); // 参数个数
echo $method->getParameters(); // 参数对象数组

更多PHP的反射類別ReflectionClass、ReflectionMethod使用實例相關文章請關注PHP中文網！