萬盛學電腦網

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

PHP Reflection API 完整詳解:核心類別與實戰應用

Reflection API 概覽

PHP 5 引入 Reflection API,提供類別、介面、函式、方法、參數、屬性、擴充套件等的運行時檢查能力,廣泛用於框架自動載入、依賴注入、文件生成、單元測試模擬等。

核心類別繼承關係

class Reflection { }
interface Reflector { }
class ReflectionException extends Exception { }
class ReflectionFunction implements Reflector { }
class ReflectionParameter implements Reflector { }
class ReflectionMethod extends ReflectionFunction { }
class ReflectionClass implements Reflector { }
class ReflectionObject extends ReflectionClass { }
class ReflectionProperty implements Reflector { }
class ReflectionExtension implements Reflector { }

主要類別方法速查

Reflection(工具類)

  • export(Reflector $r, bool $return = false):匯出詳細資訊
  • getModifierNames(int $modifiers):取得修飾詞名稱陣列

ReflectionFunction / ReflectionMethod

  • getName()、isInternal()、isUserDefined()
  • getFileName()、getStartLine()、getEndLine()
  • getDocComment():取得 PHPDoc 註解
  • getParameters():取得 ReflectionParameter 陣列
  • invoke()、invokeArgs():動態呼叫

ReflectionParameter

  • getName()、isPassedByReference()、getClass()
  • isArray()、allowsNull()、isOptional()、isDefaultValueAvailable()、getDefaultValue()

ReflectionClass

  • getName()、isInternal()、isUserDefined()、isInstantiable()
  • hasConstant()、hasMethod()、hasProperty()
  • getConstants()、getMethods()、getProperties()
  • getConstructor()、getParentClass()、getInterfaces()
  • newInstance()、newInstanceArgs()、newInstanceWithoutConstructor()

實戰應用範例:自動依賴注入

class Container {
    public function make($class) {
        $ref = new ReflectionClass($class);
        $constructor = $ref->getConstructor();
        if (!$constructor) return $ref->newInstance();

        $params = $constructor->getParameters();
        $args = [];
        foreach ($params as $param) {
            $type = $param->getClass();
            if ($type) {
                $args[] = $this->make($type->name); // 遞迴解析
            } elseif ($param->isDefaultValueAvailable()) {
                $args[] = $param->getDefaultValue();
            } else {
                throw new Exception("無法解析參數 {$param->getName()}");
            }
        }
        return $ref->newInstanceArgs($args);
    }
}

注意事項

  • 反射操作有效能成本,避免在高頻熱路徑大量使用。
  • 私有/受保護成員需呼叫 setAccessible(true) 才能存取。
  • PHP 8 新增 ReflectionAttribute 支援屬性(Attribute)反射。
copyright © 萬盛學電腦網 all rights reserved