1. 介紹
-- PHP5添加了一項新的功能:Reflection。這個功能使得phper可以reverse-engineer class, interface,function,method and extension。通過PHP代碼,就可以得到某object的所有資訊,並且可以和它互動。
-- 反射是什嗎?
它是指在PHP運行狀態中,擴充分析PHP程式,匯出或提取出關於類、方法、屬性、參數等的詳細資料,包括注釋。這種動態擷取的資訊以及動態調用對象的方法的功能稱為反射API。反射是操縱物件導向範型中元模型的API,其功能十分強大,可協助我們構建複雜,可擴充的應用。
其用途如:自動載入外掛程式,自動產生文檔,甚至可用來擴充PHP語言。
php反射api由若干類組成,可協助我們用來訪問程式的中繼資料或者同相關的注釋互動。藉助反射我們可以擷取諸如類實現了那些方法,建立一個類的執行個體(不同於用new建立),調用一個方法(也不同於常規調用),傳遞參數,動態調用類的靜態方法。
反射api是php內建的oop技術擴充,包括一些類,異常和介面,綜合使用他們可用來協助我們分析其它類,介面,方法,屬性,方法和擴充。這些oop擴充被稱為反射。
通過ReflectionClass,我們可以得到Person類的以下資訊:
1)常量 Contants
2)屬性 Property Names
3)方法 Method Names靜態
4)屬性 Static Properties
5)命名空間 Namespace
6)Person類是否為final或者abstract
2. 具體例子
建立一個Person類,然後使用ReflectionClass反射它
2.1)【建立Persion類】
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; publicfunction 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; } }Persion
2.2)【反射過程】
接下來反射它,只要把類名"Person"傳遞給ReflectionClass就可以了:
$class = new ReflectionClass('Person');//建立 Person這個類的反射類$instance = $class->newInstanceArgs($args);//相當於執行個體化Person 類
2.3)【反射後使用】
2.3.1)擷取屬性(Properties)
$properties = $class->getProperties(); foreach($properties as $property) { echo $property->getName()."\n"; } // 輸出: // _allowDynamicAttributes // id // name // biography
預設情況下,ReflectionClass會擷取到所有的屬性,private 和 protected的也可以。如果只想擷取到private屬性,就要額外傳個參數:
privateproperties=privateproperties=class->getProperties(ReflectionProperty::IS_PRIVATE);
可用參數列表:
ReflectionProperty::IS_STATIC
ReflectionProperty::IS_PUBLIC
ReflectionProperty::IS_PROTECTED
ReflectionProperty::IS_PRIVATE
如果要同時擷取public 和private 屬性,就這樣寫:ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PROTECTED。
通過$property->getName()可以得到屬性名稱。
2.3.2)【擷取注釋】
通過getDocComment可以得到寫給property的注釋。
foreach($propertiesas$property) { if($property->isProtected()) { $docblock = $property->getDocComment(); preg_match('/ type\=([a-z_]*) /', $property->getDocComment(), $matches); echo$matches[1]."\n"; } } // Output: // primary_autoincrement // varchar // text
2.3.3)【擷取類的方法】
擷取方法(methods):通過getMethods() 來擷取到類的所有methods。
2.3.4)【執行類的方法】
$instance->getBiography(); //執行Person 裡的方法getBiography //或者: $ec=$class->getmethod('getName'); //擷取Person 類中的getName方法 $ec->invoke($instance); //執行getName 方法