深刻浅出 Laravel 的 Facade 外观系统

时间  2019-11-16
标签 深刻 laravel facade 外观 系统 繁體版
原文   原文链接
本文首发于 深刻浅出 Laravel 的 Facade 外观系统，转载请注明出处。

今天咱们将学习 Laravel 核心架构中的另外一个主题「Facade（外观）」。php

本文将从如下几个方面出发，全面讲解 Laravel 中 Facade 的运行原理，为了便于理解后续中全部 Facade 译做「外观」：html

  • 简单介绍「外观」设计模式；
  • Laravel「外观」的加载原理；
  • Laravel「外观」基本使用。

什么是「外观」设计模式

外观模式定义

为子系统中的一组接口提供一个统一的入口。外观模式定义了一个高层接口，这个接口使得这一子系统更加容易使用。java

外观模式是一种使用频率很是高的结构型设计模式，它经过引入一个外观角色来简化客户端与子系统之间的交互，
为复杂的子系统调用提供一个统一的入口，下降子系统与客户端的耦合度，且客户端调用很是方便。 - 设计模式 Java 版

核心 就是在 客户端（使用者） 与 子系统（接口或服务） 之间引入一个「外观」角色。laravel

将使用者与子系统从直接耦合，转变成由「外观」类提供统一的接口给使用者使用，以下降客户端与子系统之间的耦合度。git

结构示意图：

design pattern of facade

关于「外观模式」能够阅读 设计模式 Java 版 - 外观模式github

Laravel 外观组件

Laravel 中的「外观」组件其实是服务容器中底层类的「静态代理」，它将 Laravel 内核中定义的「Contracts（在 Laravel 中又
称为服务、契约或者一般咱们所说的接口）」，以静态可调用的方式封装到各个「外观」服务中供咱们使用。bootstrap

外观加载原理

在讲解如何使用外观组件以前，咱们依旧先去深刻分析「外观」组件是如何被 Laravel 加载到项目中的。这一步是
用好「外观」组件的前提。设计模式

外观组件配置

全部内置的外观组件的配置数据，同 Laravel 其它服务同样被定义在 config/app.php 文件中。让咱们来浏览一下 aliases 节点的配置数据吧：数组

...
    'aliases' => [

        'App' => Illuminate\Support\Facades\App::class,
        'Artisan' => Illuminate\Support\Facades\Artisan::class,
        ...
    ],
    ...

外观配置定义格式遵循 「别名」：「外观类」 的数据格式。当一个 HTTP 请求被接收时，将在处理请求阶段将这些「外观」组件加载到服务中。架构

接下来将深刻分析外观服务的加载过程。

加载外观服务

「外观」服务的加载工做由定义在 Illuminate\Foundation\Http\Kernel 内核中的 \Illuminate\Foundation\Bootstrap\RegisterFacades::class 启动程序完成。

引导启动外观服务

若是你已经阅读个人另外一篇文章 深刻剖析 Laravel 服务提供者实现原理，你应该对引导程序不会太陌生。

引导程序将在处理 HTTP 请求是完成引导启动 bootstrap()。因此这里咱们须要深刻到 RegisterFacades 类的内部去了解更多细节上的处理。

<?php

namespace Illuminate\Foundation\Bootstrap;

use Illuminate\Foundation\AliasLoader;
use Illuminate\Support\Facades\Facade;
use Illuminate\Foundation\PackageManifest;
use Illuminate\Contracts\Foundation\Application;

/**
 * @link https://github.com/laravel/framework/blob/56a58e0fa3d845bb992d7c64ac9bb6d0c24b745a/src/Illuminate/Foundation/Bootstrap/RegisterFacades.php
 */
class RegisterFacades
{
    /**
     * Bootstrap the given application. 引导启动服务
     */
    public function bootstrap(Application $app)
    {
        // 清除已解析的「外观」服务实例
        Facade::clearResolvedInstances();

        // 将 Laravel 服务容器注入到「外观」服务
        Facade::setFacadeApplication($app);

        // 加载全部外观服务
        AliasLoader::getInstance(array_merge(
            $app->make('config')->get('app.aliases', []),
            $app->make(PackageManifest::class)->aliases()
        ))->register();
    }
}

加载外观服务有 AliasLoader 组件完成：

  • 首先，会从配置文件 config/app.php 中读取全部的「外观」服务配置 aliases；
  • 再从清单文件中读取别名服务 $app->make(PackageManifest::class)->aliases()；
  • 将两个配置数组合并后注入到 AliasLoader 完成 注册（register）。

注册外观服务

最后咱们来瞧瞧 AliasLoader 加载器是如何将全部的「外观」服务加载到系统中的。

<?php

namespace Illuminate\Foundation;

/**
 * @link https://github.com/laravel/framework/blob/56a58e0fa3d845bb992d7c64ac9bb6d0c24b745a/src/Illuminate/Foundation/AliasLoader.php
 */
class AliasLoader
{
    /**
     * Get or create the singleton alias loader instance. 获取或建立「别名加载器」单例实例。
     */
    public static function getInstance(array $aliases = [])
    {
        if (is_null(static::$instance)) {
            return static::$instance = new static($aliases);
        }

        $aliases = array_merge(static::$instance->getAliases(), $aliases);

        static::$instance->setAliases($aliases);

        return static::$instance;
    }

    /**
     * Set the registered aliases. 设置需注册别名数据。
     */
    public function setAliases(array $aliases)
    {
        $this->aliases = $aliases;
    }

    /**
     * Register the loader on the auto-loader stack. 将加载器注册到自动加载中。
     */
    public function register()
    {
        if (! $this->registered) {
            $this->prependToLoaderStack();

            $this->registered = true;
        }
    }

    /**
     * Prepend the load method to the auto-loader stack. 设置自动加载方法。
     */
    protected function prependToLoaderStack()
    {
        // 将 AliasLoader 的 load 方法做为 __autoload 的实现
        spl_autoload_register([$this, 'load'], true, true);
    }

    /**
     * Load a class alias if it is registered.从注册过的服务中加载这个「外观」服务。
     */
    public function load($alias)
    {
        if (static::$facadeNamespace && strpos($alias, static::$facadeNamespace) === 0) {
            $this->loadFacade($alias);

            return true;
        }

        if (isset($this->aliases[$alias])) {
            return class_alias($this->aliases[$alias], $alias);
        }
    }
}

注意 这里是知识点，在 AliasLoader->register() 完成「外服服务注册」涉及 PHP 两个知识的应用：

  • PHP 内置魔术方法 __autoload 的使用；
  • PHP 如何给类建立别名。

➤ 1. 外观服务的动态引入

咱们知道 __autoload 魔术方法的做用是尝试加载未经定义的类，这样当咱们使用一个未经引入的类时，则会自动的给咱们引入这个类。

更优的解决方案是经过 spl_autoload_register 函数，将自定义的类加载程序做为 __autoload 的实现，以替代默认 __autoload() 模式函数或方法的行为。

全部 prependToLoaderStack() 方法：

/**
     * Prepend the load method to the auto-loader stack. 设置自动加载方法。
     */
    protected function prependToLoaderStack()
    {
        // 将 AliasLoader 的 load 方法做为 __autoload 的实现
        spl_autoload_register([$this, 'load'], true, true);
    }

就是去完成这样的做用，将 AliasLoader->load() 方法做为自动加载程序的实现，在使用「外观」服务时动态引入这个类。

➤ 2. 支持外观服务别名

咱们已经了解到当「外观」服务被使用时，由 AliasLoader->load() 去自动加载这个类。

与此同时，load 方法经过 class_alias($original, $alias) 函数完成别名注册。

这样，当咱们使用 App 类时实际上就是在使用 Illuminate\Support\Facades\App 类。

很完美么，咱们的「狗蛋」终于与「世界上最好的语言」画上了等号。你就是我，我就是你。

到这里其实已经完成了「外观」服务工做原理分析工做的 70%。

探秘 Facade

最后咱们将揭开 Facade 的神秘面纱，研究一下 Laravel 是如何实现 Facade 设计模式的。

咱们拿 IlluminateSupportFacadesApp 外观服务开刀，去解开相似 App::make() 静态方法使用的奥秘。

深刻 FacadesApp：

<?php

namespace Illuminate\Support\Facades;

class App extends Facade
{
    /**
     * Get the registered name of the component.
     */
    protected static function getFacadeAccessor()
    {
        return 'app';
    }
}

咱们看到它的实现内部仅仅定义了一个 getFacadeAccessor 方法，该方法的功能是获取已注册组件的名称 app;除此以外，一无全部。

看来在这里咱们得不到什么有用的信息了。继续调查基类 IlluminateSupportFacadesFacade。若是你有去通便浏览所有的源码。

<?php

namespace Illuminate\Support\Facades;

use Mockery;
use RuntimeException;
use Mockery\MockInterface;

/**
 * @link https://github.com/laravel/framework/blob/5.6/src/Illuminate/Support/Facades/Facade.php
 */
abstract class Facade
{
    /**
     * Handle dynamic, static calls to the object.
     */
    public static function __callStatic($method, $args)
    {
        $instance = static::getFacadeRoot();

        if (! $instance) {
            throw new RuntimeException('A facade root has not been set.');
        }

        return $instance->$method(...$args);
    }
}

你会发现这个 Facade 基类并无定义相似 make 的方法，那么这里可以静态调用 App::make() 看来是须要从 __callStatic 着手才行。

不过在这里咱们须要再次厘清一个事实：「外观」模式的功能是什么?

将使用者与子系统从直接耦合，转变成由「外观」类提供统一的接口给使用者使用，以下降客户端与子系统之间的耦合度。

这句话的意思就是我「外观」啥也不提供，就是一层对服务（或者说组件或接口）的封装，而后以统一的方式提供给大家外部调用。

好了如今咱们来看看 Facade::__callStatic 是如何获取实际的服务并调用响应的方法的吧。

  • 首先，经过 getFacadeRoot 静态方法获取实际服务的实例对象；
  • 而后，调用实例对象的相关方法并返回处理结果。
<?php

namespace Illuminate\Support\Facades;

use Mockery;
use RuntimeException;
use Mockery\MockInterface;

abstract class Facade
{
    /**
     * Get the root object behind the facade. 从 facade 中解析出真实服务的对象
     */
    public static function getFacadeRoot()
    {
        return static::resolveFacadeInstance(static::getFacadeAccessor());
    }

    /**
     * Resolve the facade root instance from the container.me 从 Laravel 服务容器中解析出真实服务的对象
     */
    protected static function resolveFacadeInstance($name)
    {
        if (is_object($name)) {
            return $name;
        }

        if (isset(static::$resolvedInstance[$name])) {
            return static::$resolvedInstance[$name];
        }

        return static::$resolvedInstance[$name] = static::$app[$name];
    }
}

从 getFacadeRoot 解析对象的功能中咱们能够看到：它会调用实现「外观」的 getFacadeAccessor 方法获取到组件（服务或者说接口）的名称；而后从 Laravel 服务容器 static::$app[$name]（app 是在 RegisterFacades 中注册到「外观」中） 中解析出相关服务。

到这里，咱们就将「外观」服务的基本工做原理给分析透彻了。

另外有关「外观」组件的一些细枝末节，如：

仍是须要你自行深刻到 Facade 基类去一探究竟。

扫盲 ArrayAccess 接口

另外补充一个知识点就是关于 static::$app[$name] 这一句代码。你不经要问，这有啥好补充的呢，不就是一个简单获取数据么。

获取数据不假，简单也不假。

不过你仔细看一下，你会发现 static::$app 静态成员变量难道不是一个 \Illuminate\Contracts\Foundation\Application 实现实例么，怎么能够从对象中以数组的方式获取值呢？

这是由于咱们的服务容器 Illuminate\Container\Container 实现了 ArrayAccess 接口。

该接口的功能是提供像访问数组同样访问对象的能力的接口，这样就能够像数组同样访问对象访问成员。

/**
 *@link https://github.com/laravel/framework/blob/5.6/src/Illuminate/Container/Container.php
 */
class Container implements ArrayAccess, ContainerContract
{
    /**
     * Get the value at a given offset. 获取一个偏移位置的值，实际上从容器中解析出服务。
     */
    public function offsetGet($key)
    {
        return $this->make($key);
    }
}

Laravel「外观」基本使用

外观服务的一个典型使用场景是在定义路由时使用 Route::get('/', ...)。这样一看彷佛「Laravel 别名服务」也就不这么神秘了。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程