反射是操縱面向對象范型中元模型的API，其功能十分強大，可幫助我們構建復
雜，可擴展的應用。其用途如：自動加載插件，自動生成文檔，甚至可用來擴充
PHP 語言。php 反射api 由若干類組成，可幫助我們用來訪問程序的元數據或者
同相關的注釋交互。借助反射我們可以獲取諸如類實現了那些方法，創建一個類
的實例（不同於用new 創建），調用一個方法（也不同於常規調用），傳遞參數，
動態調用類的靜態方法。
*
**
反射api 是php 內建的oop 技術擴展，包括一些類，異常和接口，綜合使用他們
可用來幫助我們分析其它類，接口，方法，屬性，方法和擴展。這些oop 擴展被
稱為反射，位於php 源碼/ext/reflection 目錄下。
可以使用反射api 自省反射api 本身（這可能就是反射最初的意思，自己“看”自己）：
<?php
Reflection::export(new ReflectionExtension('reflection'));
?>
幾乎所有的反射api 都實現了reflector 接口，所有實現該接口的類都有一個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 中的屬性等。
***
****
現在商業軟件很多都是基於插件架構的，比如eclipse，和visual studio，netbeans
等一些著名IDE 都是基於插件的GUI 應用。第三方或本方開發插件時，必須導入
定義好的相關接口，然後實現這些接口，最後把實現的包放在指定目錄下，宿主
應用程序在啟動時自動檢測所有的插件實現，並加載它們。如果我們自己想實現
這樣的架構也是可能的。
<?php
//先定義UI 接口
interface IPlugin {
//獲取插件的名字
public static function getName();
//要顯示的菜單項
function getMenuItems();
//要顯示的文章
function getArticles();
//要顯示的導航欄
function getSideBars();
}
//一下是對插件接口的實現
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.遍歷所有
類，判斷其是否實現了我們自定義的插件接口IPlugin。3.獲取所有的插件實現。4.
在宿主應用中與插件交互
下面這個方法幫助我們找到實現了插件接口的所有類：
function findPlugins() {
$plugins = array();
foreach(get_declared_classes() as $class) {
$reflectionClass = new ReflectionClass($class);
//判斷一個類是否實現了IPlugin 接口
if($reflectionClass->implementsInterface('IPlugin')) {
$plugins[] = $reflectionClass;
}
}
return $plugins;
}
注意到所有的插件實現是作為反射類實例返回的，而不是類名本身，或是類的實
例。因為如果使用反射來調用方法還需要一些條件判斷。
判斷一個類是否實現了某個方法使用反射類的hasMethod（）方法。
接下來我們把所有的插件菜單項放在一個菜單上。
function integratePlugInMenus() {
$menu = array();
//遍歷所有的插件實現
foreach(findPlugins() as $plugin) {
//判斷插件是否實現了getMenuItems 方法
if($plugin->hasMethod('getMenuItems')) {
/*實例化一個方法實例（注意當你將類和方法看成概念時，它們就可以有實例，
就像“人”這個概念一樣），該方法返回的是ReflectionMethod 的實例*/
$reflectionMethod = $plugin->getMethod('getMenuItems');
//如果方法是靜態的
if($reflectionMethod->isStatic()) {
//調用靜態方法，注意參數是null 而不是一個反射類實例
$items = $reflectionMethod->invoke(null);
} else {
//如果方法不是靜態的，則先實例化一個反射類實例所代表的類的實例。
$pluginInstance = $plugin->newInstance();
//使用反射api 來調用一個方法，參數是通過反射實例化的對象引用
$items = $reflectionMethod->invoke($pluginInstance);
}
//合並所有的插件菜單項為一個菜單。
$menu = array_merge($menu, $items);
}
}
return $menu;
}
這裡主要用到的反射方法實例的方法調用：
public mixed invoke(stdclass object, mixed args=null);
請一定搞清楚我們常規方法的調用是這種形式：$objRef->someMethod($argList...);
因為使用了反射，這時你在想調用一個方法時形式變為：
$reflectionMethodRef->invoke($reflectionClassRef,$argList...);
如果使用反射調用方法，我們必須實例化一個反射方法的實例，如果是實例方法
還要有一個實例的引用，可能還需傳遞必要的參數。當調用一個靜態方法時，顯
式傳入null 作為第一參數。
對插件類實現的其他方法有類似的處理邏輯，這裡不再敷述。
以下是我的一個簡單測試：
<?php
/**
* 定義一個插件接口
* */
interface IPlugIn
{
/**
* getSidebars()
*
* @return 返回側導航欄
*/
public function getSidebars();
/**
* GetName()
*
* @return 返回類名
*/
public static function GetName();
}
/*下面是對插件的實現，其實應該放在不同的文件中，甚至是不同的包中*/
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';
}
}
//第二個插件實現；
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;
}
/*加載所有的插件實現：*/
protected function findPlugins()
{
$plugins = array();
foreach (get_declared_classes() as $class) {
$reflectionClass = new ReflectionClass($class);
if ($reflectionClass->implementsInterface('IPlugin')) {
$plugins[] = $reflectionClass;
}
}
return $plugins;
}
/**加載組裝所有插件實現***/
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 是自己定義的！！！
//根據分析的結果來執行方法，或者傳遞參數等
if(xxxx){
$reflectionMethod->invoke($pluginInstance) ;
}
?>
因為注釋畢竟是字符串，可以使用任何字符串解析技術，提取有用的信息，再根
據這些信息來調用方法，就是說程序的邏輯不光可由方法實現決定，還可能由注
釋決定（前提是你使用了反射，注釋格式嚴格有要求）。
××××
*****
反射api 和其他類一樣可被繼承擴展，所以我們可以為這些api 添加自己的功能。
結合自定義注釋標記。就是以@開頭的東東，標注（Java 中稱為annotation），.net
中稱為屬性attribute（或稱為特性）。然後擴展Reflection 類，就可以實現強大的
擴展功能了。
值得一提的是工廠方法設計模式（GOF 之一），也常使用反射來實例化對象，下
面是示例性質的偽碼：
Class XXXFactory{
function getInstance($className){
$reflectionClass =new ReflectionClass($className);
return $reflectionClass->newInstance();
}
//使用接口的那個類實現，可能來自配置文件
function getInstance(){
$pathOfConfig = "xxx/xx/XXXImplement.php";
$className= Config->getItem($pathOfClass,'SomeClassName');
return $this->getInstance($className);
}
}
*****
