PHP 的反射 API 允許在腳本運行時動態分析類、介面、方法、屬性等結構資訊。簡單說,它能讓程式「自我檢視」,在不預先知道類定義的情況下,取得類的完整元數據。這對於建立框架、實現依賴注入、動態代理、插件系統等進階架構極為關鍵。
ReflectionClass 是反射 API 的入口,能報告一個類的所有公開資訊。以下範例展示如何獲取物件的方法與屬性列表:
<?php
class Person {
public $name = 'John';
public function say() { echo 'Hello'; }
public function __set($k, $v) { $this->$k = $v; }
public function __get($k) { return $this->$k ?? null; }
}
$student = new Person();
$ref = new ReflectionClass($student);
$methods = $ref->getMethods();
$props = $ref->getProperties();
foreach ($methods as $m) echo $m->name . ' '; // 輸出: name say __set __get
foreach ($props as $p) echo $p->name . ' '; // 輸出: name

若只需簡單取得屬性陣列,內建函式也能勝任:
$arr = get_object_vars($student); // 取得實例屬性關聯陣列
$arr = get_class_vars('Person'); // 取得類預設屬性關聯陣列

反射 API 讓我們能在運行時動態攔截方法呼叫,實現:
__call 搭配反射,將呼叫轉發至真實物件,並加入日誌、權限檢查等橫切關注點。下圖展示一個簡易動態代理的實現思路:

反射 API 雖強大,但會帶來效能開銷。建議在框架啟動、配置解析等非熱點路徑使用;高頻業務邏輯仍應優先採用靜態類型提示與介面契約。善用反射,能讓 PHP 專案擁有更靈活的擴展能力。