1. 內省(Introspection)函式

Introspection(內省)程式在執行時檢查物件的型別或屬性的能力，他允許物件類由程式設計師操縱。
你將會發現introspection 相當有用當你不知道哪一個類後或者方法在設計時需要被執行.

Introspection 在 PHP 提供非常有用的能力去檢查類(classes), 介面(interfaces), 屬性(properties), 
和方法(methods). PHP 提供了大量的函式你能用他來完成這些檢查任務. 
為了幫助你理解introspection, 我將簡要概述一些 PHP的 類(classes),方法(methods

第一個例子, 我會展示一些 PHP的 introspection functions. 你能使用這些功能functions 
去檢查基礎的資訊包括關於類(classes)像他們的名字(name), 父類的名字等等.

<?php 
class_exists() # 檢查一個類是否被定義
get_class()    # 返回物件的類名
get_parent_class() # 返回物件的類的父類名
is_subclass_of() # 檢查一個物件是否是給定父類的 子類
?>
 

<?php
class Introspection
{
    public function description() {
        echo "I am a super class for the Child class.n";
    }
}

class Child extends Introspection
{
    public function description() {
        echo "I'm " . get_class($this) , " class.n";
        echo "I'm " . get_parent_class($this) , "'s child.n";
    }
}

if (class_exists("Introspection")) {
    $introspection = new Introspection();
    echo "The class name is: " . get_class($introspection) . "n"; 
    $introspection->description();
}

if (class_exists("Child")) {
    $child = new Child();
    $child->description();

    if (is_subclass_of($child, "Introspection")) {
        echo "Yes, " . get_class($child) . " is a subclass of Introspection.n";
    }
    else {
        echo "No, " . get_class($child) . " is not a subclass of Introspection.n";
    }
}
?>
 

這是第二個例子，其中包含ICurrencyConverter介面和GBPCurrencyConverter類的定義，
並輸出上面列出的函式提取的資訊。 與第一個例子一樣，我將首先列出這些函式，然後顯示一些程式碼。

<?php 
get_declared_classes() # 返回一系列已經定義的類
get_class_methods()  # 返回給定【類|物件】的所有方法 private 和 protected 方法會被跳過
get_class_vars() # 返回當前【類名】的預設屬性 private 和 protected 屬性會被跳過
interface_exists() # 檢查某個【介面名】是否 被定義
method_exists()  # 檢查一個類/物件是否定義某個方法
?>

<?php
interface ICurrencyConverter
{
    public function convert($currency, $amount);
}

class GBPCurrencyConverter implements ICurrencyConverter
{
    public $name = "GBPCurrencyConverter";
    public $rates = array("USD" => 0.622846,
                          "AUD" => 0.643478);
    protected $var1;
    private $var2;

    function __construct() {}

    function convert($currency, $amount) {
        return $rates[$currency] * $amount;
    }
}

if (interface_exists("ICurrencyConverter")) {
    echo "ICurrencyConverter interface exists.n";
}

$classes = get_declared_classes();
echo "The following classes are available:n";
print_r($classes);

if (in_array("GBPCurrencyConverter", $classes)) {
    print "GBPCurrencyConverter is declared.n";
 
    $gbpConverter = new GBPCurrencyConverter();

    $methods = get_class_methods($gbpConverter);
    echo "The following methods are available:n";
    print_r($methods);

    $vars = get_class_vars("GBPCurrencyConverter");
    echo "The following properties are available:n";
    print_r($vars);

    echo "The method convert() exists for GBPCurrencyConverter: ";
    var_dump(method_exists($gbpConverter, "convert"));
}

2. 反射(Reflection)API

PHP通過他的Reflection類 API支援反射. 就像你在php官方手冊中看到的, 
Reflection類API比 introspection 方法更慷慨，提供了大量的類(classes)和(methods)
可以用來完成反射任務. ReflectionClass 是 API的主類 並用於對類，介面和方法應用反射，
並提取有關所有類元件的資訊。Reflection在應用程式程式碼中很容易實現，像內省一樣也很直觀。

下面有個例子來解釋 reflection使用相同的定義 ICurrencyConverter 介面
以及子類 GBPCurrencyConverter:

<?php
$child = new ReflectionClass("Child");
$parent = $child->getParentClass();
echo $child->getName() . " is a subclass of " . $parent->getName() . ".n";

$reflection = new ReflectionClass("GBPCurrencyConverter");
$interfaceNames = $reflection->getInterfaceNames();
if (in_array("ICurrencyConverter", $interfaceNames)) {
    echo "GBPCurrencyConverter implements ICurrencyConverter.n";
}

$methods = $reflection->getMethods();
echo "The following methods are available:n";
print_r($methods);

if ($reflection->hasMethod("convert")) {
    echo "The method convert() exists for GBPCurrencyConverter.n";
}
?>

下面是輸出:

Child is a subclass of Introspection.
GBPCurrencyConverter implements ICurrencyConverter.
The following methods are available:
Array
(
    [0] => ReflectionMethod Object
        (
            [name] => __construct
            [class] => GBPCurrencyConverter
        )


    [1] => ReflectionMethod Object
        (
            [name] => convert
            [class] => GBPCurrencyConverter
        )
)

getInterfaceNames() 返回當前類例項化的介面的名字. 
getParentClass() 返回一個 ReflectionClass 物件 表示這個父類或者 false（如果沒有父類的話）.
 為了列舉出 ReflectionClass 物件的名字, 你可以使用 getName() 方法, 就像你在上面的方法中看到的.

 getMethods() 方法返回了一個數組的方法 還可以加一個可選引數 ReflectionMethod::IS_STATIC,IS_PUBLIC, IS_PROTECTED,IS_PRIVATE, IS_ABSTRACT, 和IS_FINAL 過率掉基於可見的方法

 Reflection API 提供了一個好的實現給你反射的能力去建立更好的應用, 像 ApiGen, 雖然進一步的討論超出了本文的目標.

總結
這篇文章裡你已經看到了如何去使用 PHP的 內省函式 和 反射 API 來獲取得到資訊關於類, 介面, 屬性, 和 方法. 獲取這些資訊的目的是在執行時更好地瞭解您的程式碼，並建立複雜的應用程式。