談談thinkphp5.1中容器(Container)和門面(Facade)的實現

tp5.1中引入了容器(Container)和門面(Facade)這兩個新的類

官方文檔已經給出了定義：

容器（Container）實現類的統一管理，確保對象實例的惟一性。

門面（Facade）爲容器（Container）中的類提供了一個靜態調用接口，相比於傳統的靜態方法調用， 帶來了更好的可測試性和擴展性，你能夠爲任何的非靜態類庫定義一個facade類。

深刻源碼，咱們來看看它究竟是如何實現的：

// 在框架目錄下的base.php文件

// 註冊核心類到容器
Container::getInstance()->bind([
    'app'                   => App::class,
    'build'                 => Build::class,
    'cache'                 => Cache::class,
    'config'                => Config::class,
    ...
]);

// 註冊核心類的靜態代理
Facade::bind([
    facade\App::class      => App::class,
    facade\Build::class    => Build::class,
    facade\Cache::class    => Cache::class,
    facade\Config::class   => Config::class,
    ...
]);

// 註冊類庫別名
Loader::addClassAlias([
    'App'      => facade\App::class,
    'Build'    => facade\Build::class,
    'Cache'    => facade\Cache::class,
    'Config'   => facade\Config::class,
    ...
]);

 

容器實現：

這裏，框架已經幫咱們綁定了系統經常使用類到容器中，在以後使用時，只須要調用助手函數 app()進行容器中的類解析調用，對於已經綁定的類標識，會自動快速實例化。

// 實例化緩存類

app('cache'); 
// app('cache', ['file']); 參數化調用

// 至關於執行了
Container::get('cache');

// 查看源碼，Container調用的實際上是make方法，在該方法裏調用反射等實現類的實例化，過程以下：

public function make($abstract, $vars = [], $newInstance = false)
{
    if (true === $vars) {
        // 老是建立新的實例化對象
        $newInstance = true;
        $vars        = [];
    }

    if (isset($this->instances[$abstract]) && !$newInstance) {
        $object = $this->instances[$abstract];
    } else {
        if (isset($this->bind[$abstract])) {
            $concrete = $this->bind[$abstract];
　　　　　　　// 閉包實現
            if ($concrete instanceof \Closure) {
                $object = $this->invokeFunction($concrete, $vars);
            } else {
                $object = $this->make($concrete, $vars, $newInstance);
            }
        } else {
　　　　　　　// 反射實現
            $object = $this->invokeClass($abstract, $vars);
        }

        if (!$newInstance) {
            $this->instances[$abstract] = $object;
        }
    }

    return $object;
}

/**
 * 調用反射執行類的實例化 支持依賴注入
 * @access public
 * @param  string    $class 類名
 * @param  array     $vars  變量
 * @return mixed
 */
public function invokeClass($class, $vars = [])
{
    $reflect     = new \ReflectionClass($class);
    $constructor = $reflect->getConstructor();

    if ($constructor) {
        $args = $this->bindParams($constructor, $vars);
    } else {
        $args = [];
    }

    return $reflect->newInstanceArgs($args);
}

/**
 * 執行函數或者閉包方法 支持參數調用
 * @access public
 * @param  string|array|\Closure $function 函數或者閉包
 * @param  array                 $vars     變量
 * @return mixed
 */
public function invokeFunction($function, $vars = [])
{
    $reflect = new \ReflectionFunction($function);
    $args    = $this->bindParams($reflect, $vars);

    return $reflect->invokeArgs($args);
}

簡而言之，容器內部是經過反射類或閉包等來實現類的實例化。

 

門面實現：

以一個例子來分析：

facade\Config::get('app_debug');

咱們來分析一下它的實現方式：

// thinkphp\library\facade\Config 類

namespace think\facade;

use think\Facade;

class Config extends Facade
{
}

// 從源代碼上看 Config自己沒有任何方法，它繼承了Facade的方法，但Facade並無get這個靜態方法
// 此時，系統自動觸發了魔術方法：__callStatic（）,Facade重寫了此方法：

public static function __callStatic($method, $params)
{
    return call_user_func_array([static::createFacade(), $method], $params);
}

// 可見，最後調用的是用戶自定義函數：call_user_func_array([實例, 方法], 參數)，爲了得到Config實例，Facade又定義了一個獲取對象的方法：

/**
 * 建立Facade實例
 * @static
 * @access protected
 * @param  string    $class          類名或標識
 * @param  array     $args           變量
 * @param  bool      $newInstance    是否每次建立新的實例
 * @return object
 */
protected static function createFacade($class = '', $args = [], $newInstance = false)
{
    $class       = $class ?: static::class;
    $facadeClass = static::getFacadeClass();

    if ($facadeClass) {
        $class = $facadeClass;
    } elseif (isset(self::$bind[$class])) {
        $class = self::$bind[$class];
    }

    if (static::$alwaysNewInstance) {
        $newInstance = true;
    }

    return Container::getInstance()->make($class, $args, $newInstance);
}

// 其內部是經過容器來實例化對象
// 由於在base.php中已經將 think\Config 類綁定到 config 這個標識

Container::getInstance()->bind([
　　'config'  => Config::class
])

// 在 createFacade 方法中，獲取類的名稱：$class = $class ?: static::class; 即獲得 config 這個標識

// 在容器的make方法中，根據config標識，找到綁定的 think\Config 類，並調用其動態方法 get。

facade\Config::get('app_debug'); 

// 最後調用的是：

(new think\Config())->get('app_debug');

 簡而言之，門面的實現是經過PHP的魔術方法 __callStatic，再配合容器來實現動態類的靜態化調用。