反射是什么?
它是指在PHP運行狀態(tài)中,擴展分析PHP程序,導出或提取出關于類、方法、屬性、參數等的詳細信息,包括注釋。這種動態(tài)獲取的信息以及動態(tài)調用對象的方法的功能稱為反射API。
反射是操縱面向對象范型中元模型的API,其功能十分強大,可幫助我們構建復雜,可擴展的應用。其用途如:自動加載插件,自動生成文檔,甚至可用來擴充PHP語言。php反射api由若干類組成,可幫助我們用來訪問程序的元數據或者同相關的注釋交互。借助反射我們可以獲取諸如類實現(xiàn)了那些方法,創(chuàng)建一個類的實例(不同于用new創(chuàng)建),調用一個方法(也不同于常規(guī)調用),傳遞參數,動態(tài)調用類的靜態(tài)方法。
*
**
反射api是php內建的oop技術擴展,包括一些類,異常和接口,綜合使用他們可用來幫助我們分析其它類,接口,方法,屬性,方法和擴展。這些oop擴展被稱為反射,位于php源碼/ext/reflection目錄下。
可以使用反射api自省反射api本身(這可能就是反射最初的意思,自己"看"自己):
<?php
Reflection::export(new ReflectionExtension('reflection'));
?>
幾乎所有的反射api都實現(xiàn)了reflector接口,所有實現(xiàn)該接口的類都有一個export方法,該方法打印出參數對象的相關信息。
使用get_declared_classes()獲取所有php內置類,get_declared_interfaces();
get_defined_functions();
get_defined_vars(); get_defined_constants();可獲取php接口,方法,變量,常量信息。
**
***
反射初探:
<?php
//定義一個自定義類
class MyTestClass{
public function testFunc($para0='defaultValue0'){
}
}
//接下來反射它
foreach(get_declared_classes() as $class){
//實例化一個反射類
$reflectionClass = new ReflectionClass($class);
//如果該類是自定義類
if($reflectionClass->isUserDefined()){
//導出該類信息
Reflection::export($reflectionClass);
}
}
?>
以上片段實例如何查看自定義類的基本信息。
描述數據的數據被稱為元數據,用反射獲取的信息就是元數據信息,這些信息用來描述類,接口方法等等。(元---》就是原始之意,比如元模型就是描述模型的模型,比如UML元模型就是描述UML結構的模型),元數據進一步可分為硬元數據(hard matadata)和軟元數據(soft metadata),前者由編譯代碼導出,如類名字,方法,參數等。
后者是人為加入的數據,如phpDoc塊,php中的屬性等。
***
****
現(xiàn)在商業(yè)軟件很多都是基于插件架構的,比如eclipse,和visual studio,netbeans等一些著名IDE都是基于插件的GUI應用。第三方或本方開發(fā)插件時,必須導入定義好的相關接口,然后實現(xiàn)這些接口,最后把實現(xiàn)的包放在指定目錄下,宿主應用程序在啟動時自動檢測所有的插件實現(xiàn),并加載它們。如果我們自己想實現(xiàn)這樣的架構也是可能的。
<?php
//先定義UI接口
interface IPlugin {
//獲取插件的名字
public static function getName();
//要顯示的菜單項
function getMenuItems();
//要顯示的文章
function getArticles();
//要顯示的導航欄
function getSideBars();
}
//一下是對插件接口的實現(xiàn)
class SomePlugin implements IPlugin {
public function getMenuItems() {
//返回菜單項
return null;
}
public function getArticles() {
//返回我們的文章
return null;
}
public function getSideBars() {
//我們有一個導航欄
return array('SideBarItem');
}
//返回插件名
public static function getName(){
return "SomePlugin";
}
}
?>
php中也有使用插件的解決方案,不像eclipse。
使用我們的插件:1.先使用get_declared_classes()獲取所有已加載類。2.遍歷所有類,判斷其是否實現(xiàn)了我們自定義的插件接口IPlugin。3.獲取所有的插件實現(xiàn)。4.在宿主應用中與插件交互
下面這個方法幫助我們找到實現(xiàn)了插件接口的所有類:
function findPlugins() {
$plugins = array();
foreach(get_declared_classes() as $class) {
$reflectionClass = new ReflectionClass($class);
//判斷一個類是否實現(xiàn)了IPlugin接口
if($reflectionClass->implementsInterface('IPlugin')) {
$plugins[] = $reflectionClass;
}
}
return $plugins;
}
注意到所有的插件實現(xiàn)是作為反射類實例返回的,而不是類名本身,或是類的實例。因為如果使用反射來調用方法還需要一些條件判斷。
判斷一個類是否實現(xiàn)了某個方法使用反射類的hasMethod()方法。
接下來我們把所有的插件菜單項放在一個菜單上。
function integratePlugInMenus() {
$menu = array();
//遍歷所有的插件實現(xiàn)
foreach(findPlugins() as $plugin) {
//判斷插件是否實現(xiàn)了getMenuItems方法
if($plugin->hasMethod('getMenuItems')) {
/*實例化一個方法實例(注意當你將類和方法看成概念時,它們就可以有實例,就像"人"這個概念一樣),該方法返回的是ReflectionMethod的實例*/
$reflectionMethod = $plugin->getMethod('getMenuItems');
//如果方法是靜態(tài)的
if($reflectionMethod->isStatic()) {
//調用靜態(tài)方法,注意參數是null而不是一個反射類實例
$items = $reflectionMethod->invoke(null);
} else {
//如果方法不是靜態(tài)的,則先實例化一個反射類實例所代表的類的實例。
$pluginInstance = $plugin->newInstance();
//使用反射api來調用一個方法,參數是通過反射實例化的對象引用
$items = $reflectionMethod->invoke($pluginInstance);
}
//合并所有的插件菜單項為一個菜單。
$menu = array_merge($menu, $items);
}
}
return $menu;
}
這里主要用到的反射方法實例的方法調用:
public mixed invoke(stdclass object, mixed args=null);
請一定搞清楚我們常規(guī)方法的調用是這種形式:$objRef->someMethod($argList...);
因為使用了反射,這時你在想調用一個方法時形式變?yōu)椋?br />
$reflectionMethodRef->invoke($reflectionClassRef,$argList...);
如果使用反射調用方法,我們必須實例化一個反射方法的實例,如果是實例方法還要有一個實例的引用,可能還需傳遞必要的參數。當調用一個靜態(tài)方法時,顯式傳入null作為第一參數。
對插件類實現(xiàn)的其他方法有類似的處理邏輯,這里不再敷述。
以下是我的一個簡單測試:
<?php
/**
* 定義一個插件接口
* */
interface IPlugIn
{
/**
* getSidebars()
*
* @return 返回側導航欄
*/
public function getSidebars();
/**
* GetName()
*
* @return 返回類名
*/
public static function GetName();
}
/*下面是對插件的實現(xiàn),其實應該放在不同的文件中,甚至是不同的包中*/
class MyPlugIn implements IPlugIn
{
public function getSidebars()
{
//構造自己的導航欄
$sideBars = '<div><ul >
<li><a href="">m1</a>
</li>
<li><a href="">m2</a>
</li>
</ul>
</div>';
return $sideBars;
}
public static function GetName()
{
return 'MyPlugIn';
}
}
//第二個插件實現(xiàn);
class MyPlugIn2 implements IPlugIn
{
public function getSidebars()
{
//構造自己的導航欄
$sideBars = '<div><ul >
<li><a href="">mm1</a>
</li>
<li><a href="">mm2</a>
</li>
</ul>
</div>';
return $sideBars;
}
public static function GetName()
{
return 'MyPlugIn2';
}
}
//在宿主程序中使用插件
class HostApp
{
public function initAll()
{
// 初始化各個部分
echo "yiqing95.";
$this->renderAll();
}
//渲染GUI格部分
function renderAll(){
$rsltSidebars="<table>";
foreach($this->integrateSidebarsOfPlugin() as $sidebarItem){
$rsltSidebars.="<tr><td>$sidebarItem</td></tr>";
}
$rsltSidebars.="</table>";
echo $rsltSidebars;
}
/*加載所有的插件實現(xiàn):*/
protected function findPlugins()
{
$plugins = array();
foreach (get_declared_classes() as $class) {
$reflectionClass = new ReflectionClass($class);
if ($reflectionClass->implementsInterface('IPlugin')) {
$plugins[] = $reflectionClass;
}
}
return $plugins;
}
/**加載組裝所有插件實現(xiàn)***/
protected function integrateSidebarsOfPlugin()
{
$sidebars = array();
foreach ($this->findPlugins() as $plugin) {
if ($plugin->hasMethod('getSidebars')) {
$reflectionMethod = $plugin->getMethod('getSidebars');
if ($reflectionMethod->isStatic()) {
$items = $reflectionMethod->invoke(null);
} else {
$pluginInstance = $plugin->newInstance();
$items = $reflectionMethod->invoke($pluginInstance) ;
}
}
//$sidebars = array_merge($sidebars, $items);
$sidebars[]=$items;
}
return $sidebars;
}
}
//運行程序:
$entryClass =new HostApp();
$entryClass->initAll();
?>
****
××××
$reflectionClass = new ReflectionClass("IPlugIn");
echo $reflectionClass-> getDocComment();
這段代碼可以幫助我們獲取類的文檔注釋,一旦我們獲取了類的注釋內容我們就可以擴展我們的類功能,比如先獲取注釋,然后分析注釋使用docblock tokenizer 『pecl擴展』,或使用自帶的Tokenizer類又或者使用正則表達式,字符串函數來解析注釋文檔,你可以在注釋中加入任何東西,包括指令,在使用反射調用前可判斷這些通過注釋傳遞的指令或數據:
<?php
//"分析相關的注釋數據"
analyse($reflectionClass-> getDocComment());//analyse是自己定義的?。。?br />
//根據分析的結果來執(zhí)行方法,或者傳遞參數等
if(xxxx){
$reflectionMethod->invoke($pluginInstance) ;
}
?>
因為注釋畢竟是字符串,可以使用任何字符串解析技術,提取有用的信息,再根據這些信息來調用方法,就是說程序的邏輯不光可由方法實現(xiàn)決定,還可能由注釋決定(前提是你使用了反射,注釋格式嚴格有要求)。
××××
*****
反射api和其他類一樣可被繼承擴展,所以我們可以為這些api添加自己的功能。結合自定義注釋標記。就是以@開頭的東東,標注(Java中稱為annotation),.net中稱為屬性attribute(或稱為特性)。然后擴展Reflection類,就可以實現(xiàn)強大的擴展功能了。
值得一提的是工廠方法設計模式(GOF之一),也常使用反射來實例化對象,下面是示例性質的偽碼:
Class XXXFactory{
function getInstance($className){
$reflectionClass =new ReflectionClass($className);
return $reflectionClass->newInstance();
}
//使用接口的那個類實現(xiàn),可能來自配置文件
function getInstance(){
$pathOfConfig = "xxx/xx/XXXImplement.php";
$className= Config->getItem($pathOfClass,'SomeClassName');
return $this->getInstance($className);
}
}
*****