Laravel 门面类:Facade简记

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/YQXLLWY/article/details/74544199

这是另一位大哥写的,感觉写的很好,在此感谢他的分享。这位大哥的这篇文章详细介绍了原理,但是感觉初次看的人可能需要下面这个前期知识储备:

还有一点就是我的实际代码和他的有点不同,这里再贴一下实际的源码,顺道也再整理一下思路:

这里拿vendor/laravel/framework/src/Illuminate/Support/Facades/App.php为例进行介绍:

<?php
namespace Illuminate\Support\Facades;

/**
 * 这里顺道记录一个小技巧,在函数前写这样的注释,会被PHPSrorm解析,表示该类所拥有的方法
 * @method static string version()
 * @method static string basePath()
 * @method static string environment()
 * @method static bool isDownForMaintenance()
 * @method static void registerConfiguredProviders()
 * @method static \Illuminate\Support\ServiceProvider register(\Illuminate\Support\ServiceProvider|string $provider, array $options = [], bool $force = false)
 * @method static void registerDeferredProvider(string $provider, string $service = null)
 * @method static void boot()
 * @method static void booting(mixed $callback)
 * @method static void booted(mixed $callback)
 * @method static string getCachedServicesPath()
 *
 * @see \Illuminate\Foundation\Application
 */
class App extends Facade
{
    /**
     * Get the registered name of the component.
     *
     * @return string
     */
    protected static function getFacadeAccessor()
    {
        return 'app';
    }
}

当我们外部这样调用时:

use App;

/App:make('app');

时,根据服务容器的自动依赖注入,(Facade类是App类的抽象类):

<?php

namespace Illuminate\Support\Facades;

use Mockery;
use RuntimeException;
use Mockery\MockInterface;

abstract class Facade{
    //先省略其中的代码
}

会自动调用到App类,接着就是解释如何像调用静态方法一样调用App类中的方法了,根据那位大哥的解释,当我们调用getFacadeAccessor()方法时,在Facades中并没有该静态方法,那么就会调用PHP的魔术方法:__callStatic($method,$args),下面来看其源码:

public static function __callStatic($method, $args)
    {
        $instance = static::getFacadeRoot();
        //先到这里,下面讲解 static::getFacadeRoot() 这个函数
        if (! $instance) {
            throw new RuntimeException('A facade root has not been set.');
        }

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

其中的getFacadeRoot方法如下:

public static function getFacadeRoot()
    {
        //注意,最开始时我们的 getFacadeAccessor() 的返回值是 "app"
        return static::resolveFacadeInstance(static::getFacadeAccessor());
    }

接下来再看resolveFacadeInstance

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

其实简单点来说就是返回该$name的实例,接着回到最开始的__callStatic函数的剩余部分:

//如果经过上面的`resolveFacadeInstance`函数没有办法获取该类实例的话,那么接下来肯定无法正常运行了,所以这里抛出异常
if (! $instance) {
   throw new RuntimeException('A facade root has not been set.');
}
  //就是在这里调用了该类下面的方法,...$args表示该方法可能存在输入参数,可能不存在
   return $instance->$method(...$args);
阅读更多
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页