PHP的Reflection反射機制

原文地址： http://www.nowamagic.net/php/php_Reflection.php

PHP5添加了一項新的功能：Reflection。這個功能使得程序員可以

reverse-engineer[逆向工程] class, interface,function,method and extension[擴展庫支持]。

通過PHP代碼，就可以得到某object的所有信息，並且可以和它交互。

如假設以下Person類：

class Person {
    /**
     * For the sake of demonstration, we"re setting this private
     */
    private $_allowDynamicAttributes = false;
    
    /**
     * type=primary_autoincrement
     */
    protected $id = 0;
    
    /**
     * type=varchar length=255 null
     */
    protected $name;
    
    /**
     * type=text null
     */
    protected $biography;
    public function getId() {
        return $this->id;
    }
    public function setId($v) {
        $this->id = $v;
    }
    public function getName() {
        return $this->name;
    }
    public function setName($v) {
        $this->name = $v;
    }
    public function getBiography() {
        return $this->biography;
    }
    public function setBiography($v) {
        $this->biography = $v;
    }
}

通過ReflectionClass，我們可以得到Person類的以下信息：

• 常量 Contants
• 屬性 Property Names
• 方法 Method Names
• 靜態屬性 Static Properties
• 命名空間 Namespace
• Person類是否為final或者abstract

只要把類名"Person"傳遞給ReflectionClass就可以了：

$class = new ReflectionClass('Person');

*　獲取屬性(Properties)：

$properties = $class->getProperties();
foreach($properties as $property) {
    echo $property->getName()."\n";
}
// 輸出:
// _allowDynamicAttributes
// id
// name
// biography

默認情況下，ReflectionClass會獲取到所有的屬性，private 和 protected的也可以。如果只想獲取到private屬性，就要額外傳個參數：

$private_properties = $class->getProperties(ReflectionProperty::IS_PRIVATE);

可用參數列表：

• ReflectionProperty::IS_STATIC
• ReflectionProperty::IS_PUBLIC
• ReflectionProperty::IS_PROTECTED
• ReflectionProperty::IS_PRIVATE

如果要同時獲取public 和private 屬性，就這樣寫：ReflectionProperty::IS_PUBLIC | ReflectionProperty::IS_PRIVATE

通過$property->getName()可以得到屬性名，通過getDocComment可以得到寫給property的注釋。

foreach($properties as $property) {
    if($property->isProtected()) {
        $docblock = $property->getDocComment();
        preg_match('/ type\=([a-z_]*) /', $property->getDocComment(), $matches);
        echo $matches[1]."\n";
    }
}
// Output:
// primary_autoincrement
// varchar
// text

有點不可思議了吧。竟然連注釋都可以取到。

* 獲取方法(methods)：通過getMethods() 來獲取到類的所有methods。返回的是ReflectionMethod對象的數組。

不再演示。

 

賦一個利用反射加載類實例的工具類寫法：

<?php
/**
 * Desc: 反射加載類
 * Class: ClassLoader
 * Package: App\Lib
 * User: zb
 * Date: 2019/5/22 15:21
 */

namespace App\Lib;

class ClassLoader
{
    private static $obj = [];

    /**
     * 上傳類map
     */
    private static function uploadClassMap ()
    {
        $map = [
            'image' => 'App\Lib\Upload\Image',//key為傳遞參數key
            'video' => 'App\Lib\Upload\Video',
        ];
        return $map;
    }

    /**
     * model類map
     */
    private static function modelClassMap ()
    {
        $map = [
            'video' => 'App\Model\Video',
        ];
        return $map;
    }

    /**
     * aliyun類map
     */
    private static function aliyunClassMap ()
    {
        $map = [
            'vod' => 'App\Lib\Aliyun\AliyunVod',
        ];
        return $map;
    }

    /**
     * cache類map
     */
    private static function cacheClassMap ()
    {
        $map = [
            'video' => 'App\Lib\Cache\Video',
        ];
        return $map;
    }

    /**
     * 類實例map指南
     * @param string $guideKey 指南key
     * @param string $classKey classKey
     * @return array|bool
     */
    private static function guideClassMap (string $guideKey, string $classKey)
    {
        $guideKey = strtolower($guideKey);
        $guideMap = [
            'upload' => self::uploadClassMap(),
            'model' => self::modelClassMap(),
            'aliyun' => self::aliyunClassMap(),
            'cache' => self::cacheClassMap(),
        ];
        return isset($guideMap[$guideKey][$classKey]) ? $guideMap[$guideKey][$classKey] : array();
    }

    /**
     * @param string $guideKey guideKey
     * @param string $classKey classKey鍵
     * @param array $params 構造函數參數
     * @param bool $instance 是否需要實例化
     * @return object|string 返回obj或字符串
     * @throws \ReflectionException
     */
    public static function initClass (string $guideKey, string $classKey, $params = [], $instance = true)
    {
        if (!$params && isset(self::$obj[$guideKey . '-' . $classKey]) && is_object(self::$obj[$guideKey . '-' . $classKey])) {
            return self::$obj[$guideKey . '-' . $classKey];
        } else {
            unset(self::$obj[$guideKey . '-' . $classKey]);
        }

        if (!self::guideClassMap($guideKey, $classKey)) {
            throw new \ReflectionException('加載類不存在');
        }
        $class = self::guideClassMap($guideKey, $classKey);
        try {
            $obj = $instance ? (new \ReflectionClass($class))->newInstanceArgs($params) : $class;
            if (!$params) {
                self::$obj[$guideKey . '-' . $classKey] = $obj;
            }
            return $obj;
        } catch (\ReflectionException $e) {
            throw new \ReflectionException('類加載失敗');
        }
    }

}