萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

深入理解 PHP 反射 API:動態分析類結構的利器

什麼是 PHP 反射 API?

PHP 的反射 API 允許在腳本運行時動態分析類、介面、方法、屬性等結構資訊。簡單說,它能讓程式「自我檢視」,在不預先知道類定義的情況下,取得類的完整元數據。這對於建立框架、實現依賴注入、動態代理、插件系統等進階架構極為關鍵。

核心類:ReflectionClass

ReflectionClass 是反射 API 的入口,能報告一個類的所有公開資訊。以下範例展示如何獲取物件的方法與屬性列表:

範例類別:Person.php

<?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; }
}

使用 ReflectionClass 獲取資訊

$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

Person 類定義 ReflectionClass 使用示例 輸出結果

替代方案:get_class_vars() 與 get_object_vars()

若只需簡單取得屬性陣列,內建函式也能勝任:

$arr = get_object_vars($student); // 取得實例屬性關聯陣列
$arr = get_class_vars('Person');  // 取得類預設屬性關聯陣列

get_class_vars 輸出

實戰應用:Hook 機制與動態代理

反射 API 讓我們能在運行時動態攔截方法呼叫,實現:

  • 插件系統:掃描目錄下的類,自動註冊符合介面的插件。
  • 動態代理:利用 __call 搭配反射,將呼叫轉發至真實物件,並加入日誌、權限檢查等橫切關注點。

下圖展示一個簡易動態代理的實現思路:

動態代理示例

總結

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

copyright © 萬盛學電腦網 all rights reserved