Laravel 핵심 해석 파사드

이 글은 주로 Laravel에서 Facades의 핵심 해석을 소개하는데, 이는 어느 정도 참고할만한 가치가 있습니다. 이제는 모든 사람들과 공유합니다. 도움이 필요한 친구들이 참고할 수 있습니다.

Facades란 무엇입니까

Facades는 Laravel 애플리케이션 개발에서 자주 사용됩니다. 실제로 구성 요소를 구성 요소라고 부르는 것은 부적절합니다. 이는 개발자가 서비스 컨테이너에 바인딩된 다양한 서비스에 간단히 액세스할 수 있도록 하는 정적 클래스 인터페이스 또는 프록시 집합입니다. Facade는 Laravel 문서에서 다음과 같이 설명됩니다:

Facade는 애플리케이션의 서비스 컨테이너에서 사용할 수 있는 클래스에 대한 "정적" 인터페이스를 제공합니다. Laravel에는 많은 Facade가 포함되어 있으며, 여러분도 모르게 이를 사용하고 있을 수도 있습니다! 서비스 컨테이너의 기본 클래스에 대한 "정적 프록시"인 Laravel "facades"는 간결하고 표현하기 쉬운 구문의 장점을 가지면서 기존 정적 방법보다 더 높은 테스트 가능성과 유연성을 유지합니다.

우리가 자주 사용하는 경로는 IlluminateSupportFacadesRoute 클래스의 별칭인 Facade입니다. 이 Facade 클래스 프록시는 서비스 컨테이너에 등록된 라우터 서비스이므로 이를 통해 Route 클래스를 사용하면 라우터 서비스에서 제공하는 다양한 서비스를 쉽게 사용할 수 있으며, 관련된 서비스 구문 분석은 Laravel에 의해 완전히 암묵적으로 완료되므로 애플리케이션 코드가 어느 정도 훨씬 간단해집니다. 아래에서는 Laravel 프레임워크에 Facade가 등록되고 애플리케이션에서 사용되는 과정을 간략하게 살펴보겠습니다. Facade는 ServiceProvider와 긴밀하게 작동하므로 이러한 프로세스를 이해하면 사용자 정의 Laravel 구성 요소를 개발하는 데 도움이 될 것입니다. IlluminateSupportFacadesRoute类的别名，这个Facade类代理的是注册到服务容器里的router服务，所以通过Route类我们就能够方便地使用router服务中提供的各种服务，而其中涉及到的服务解析完全是隐式地由Laravel完成的，这在一定程度上让应用程序代码变的简洁了不少。下面我们会大概看一下Facades从被注册进Laravel框架到被应用程序使用这中间的流程。Facades是和ServiceProvider紧密配合的所以如果你了解了中间的这些流程对开发自定义Laravel组件会很有帮助。

注册Facades

说到Facades注册又要回到再介绍其它核心组建时提到过很多次的Bootstrap阶段了，在让请求通过中间件和路由之前有一个启动应用程序的过程：

//Class: \Illuminate\Foundation\Http\Kernel
 
protected function sendRequestThroughRouter($request)
{
    $this->app->instance('request', $request);

    Facade::clearResolvedInstance('request');

    $this->bootstrap();

    return (new Pipeline($this->app))
                    ->send($request)
                    ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
                    ->then($this->dispatchToRouter());
}

//引导启动Laravel应用程序
public function bootstrap()
{
    if (! $this->app->hasBeenBootstrapped()) {
        /**依次执行$bootstrappers中每一个bootstrapper的bootstrap()函数
         $bootstrappers = [
               'Illuminate\Foundation\Bootstrap\DetectEnvironment',
             'Illuminate\Foundation\Bootstrap\LoadConfiguration',
              'Illuminate\Foundation\Bootstrap\ConfigureLogging',
             'Illuminate\Foundation\Bootstrap\HandleExceptions',
             'Illuminate\Foundation\Bootstrap\RegisterFacades',
             'Illuminate\Foundation\Bootstrap\RegisterProviders',
             'Illuminate\Foundation\Bootstrap\BootProviders',
            ];*/
            $this->app->bootstrapWith($this->bootstrappers());
    }
}

在启动应用的过程中IlluminateFoundationBootstrapRegisterFacades这个阶段会注册应用程序里用到的Facades。

class RegisterFacades
{
    /**
     * Bootstrap the given application.
     *
     * @param  \Illuminate\Contracts\Foundation\Application  $app
     * @return void
     */
    public function bootstrap(Application $app)
    {
        Facade::clearResolvedInstances();

        Facade::setFacadeApplication($app);

        AliasLoader::getInstance(array_merge(
            $app->make('config')->get('app.aliases', []),
            $app->make(PackageManifest::class)->aliases()
        ))->register();
    }
}

在这里会通过AliasLoader类的实例将为所有Facades注册别名，Facades和别名的对应关系存放在config/app.php文件的$aliases数组中

'aliases' => [

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

看一下AliasLoader里是如何注册这些别名的

// class: Illuminate\Foundation\AliasLoader
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;
}

public function register()
{
    if (! $this->registered) {
        $this->prependToLoaderStack();

        $this->registered = true;
    }
}

protected function prependToLoaderStack()
{
    // 把AliasLoader::load()放入自动加载函数队列中，并置于队列头部
    spl_autoload_register([$this, 'load'], true, true);
}

通过上面的代码段可以看到AliasLoader将load方法注册到了SPL __autoload函数队列的头部。看一下load方法的源码：

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

在load方法里$aliases配置里的Facade类创建了对应的别名，比如当我们使用别名类Route时PHP会通过AliasLoader的load方法为把IlluminateSupportFacadesRoute::class类创建一个别名类Route，所以我们在程序里使用别Route其实使用的就是`IlluminateSupportFacadesRoute类。

解析Facade代理的服务

把Facades注册到框架后我们在应用程序里就能使用其中的Facade了，比如注册路由时我们经常用Route::get('/uri', 'Controller@action);，那么Route是怎么代理到路由服务的呢，这就涉及到在Facade里服务的隐式解析了， 我们看一下Route类的源码：

class Route extends Facade
{
    /**
     * Get the registered name of the component.
     *
     * @return string
     */
    protected static function getFacadeAccessor()
    {
        return 'router';
    }
}

只有简单的一个方法，并没有get, post, delete等那些路由方法, 父类里也没有，不过我们知道调用类不存在的静态方法时会触发PHP的__callStatic静态方法

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根对象
public static function getFacadeRoot()
{
    return static::resolveFacadeInstance(static::getFacadeAccessor());
}

/**
 * 从服务容器里解析出Facade对应的服务
 */
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];
}

通过在子类Route Facade里设置的accessor(字符串router)， 从服务容器中解析出对应的服务，router服务是在应用程序初始化时的registerBaseServiceProviders阶段（具体可以看Application的构造方法）被IlluminateRoutingRoutingServiceProvider注册到服务容器里的:

class RoutingServiceProvider extends ServiceProvider
{
    /**
     * Register the service provider.
     *
     * @return void
     */
    public function register()
    {
        $this->registerRouter();
        ......
    }

    /**
     * Register the router instance.
     *
     * @return void
     */
    protected function registerRouter()
    {
        $this->app->singleton('router', function ($app) {
            return new Router($app['events'], $app);
        });
    }
    ......
}

router服务对应的类就是IlluminateRoutingRouter, 所以Route Facade实际上代理的就是这个类，Route::get实际上调用的是IlluminateRoutingRouter对象的get方法

/**
 * Register a new GET route with the router.
 *
 * @param  string  $uri
 * @param  \Closure|array|string|null  $action
 * @return \Illuminate\Routing\Route
 */
public function get($uri, $action = null)
{
    return $this->addRoute(['GET', 'HEAD'], $uri, $action);
}

补充两点:

1. 解析服务时用的static::$app是在最开始的RegisterFacades

   Registering Facades
2. Facade 등록에 관해 말하자면, 다른 핵심 구성 요소를 소개할 때 여러 번 언급했던 Bootstrap 단계로 돌아가야 합니다. 요청이 미들웨어와 라우팅을 통과하기 전에 애플리케이션을 시작하는 과정이 있습니다.

   rrreee

   IlluminateFoundationBootstrapRegisterFacades 애플리케이션을 시작하는 과정 중 이 단계에서는 애플리케이션에 사용되는 Facade를 등록합니다.
rrreee

여기서 별칭은 AliasLoader 클래스의 인스턴스를 통해 모든 Facade에 등록됩니다. Facade와 별칭 간의 대응은 config/app.php에 저장됩니다. /code> 파일에서 $aliases 배열

rrreee

AliasLoader에 이러한 별칭이 어떻게 등록되는지 살펴보세요

rrreee

위의 코드 조각을 통해 AliasLoader가 SPL의 선두에 로드 메소드를 등록하는 것을 볼 수 있습니다. __autoload 함수 대기열. 로드 메소드의 소스 코드를 살펴보세요.

rrreee

로드 메소드에서 $aliases 구성의 Facade 클래스는 해당 별칭을 생성합니다. 예를 들어 별칭 클래스 Route 별칭 클래스 Route는 AliasLoader의 로드 메소드를 통해 IlluminateSupportFacadesRoute::class 클래스에 대해 생성되므로 별칭을 사용할 때 프로그램에서 Route는 실제로 `IlluminateSupportFacadesRoute 클래스를 사용합니다.

Facade 프록시 서비스 해결🎜🎜Facade를 프레임워크에 등록한 후 애플리케이션에서 Facade를 사용할 수 있습니다. 예를 들어 경로를 등록할 때 Route::get('/uri', 'Controller @를 사용하는 경우가 많습니다. action);, 그러면 Route는 어떻게 라우팅 서비스로 프록시됩니까? 여기에는 Facade에서 서비스의 암시적 구문 분석이 포함됩니다. Route 클래스의 소스 코드를 살펴보겠습니다. 🎜 rrreee🎜에는 간단한 메소드가 하나만 있으며 get, post, delete 등과 같은 라우팅 메소드도 없고 상위 클래스이지만 클래스에 존재하지 않는 정적 메소드를 호출하면 PHP의 __callStatic 정적 메소드가 트리거됩니다🎜rrreee🎜해당 서비스는 접근자를 통해 서비스 컨테이너에서 구문 분석됩니다(문자열 라우터) 하위 클래스 Route Facade에 설정되어 있으면 라우터 서비스는 애플리케이션이 초기화될 때 RegisterBaseServiceProviders 단계에서 IlluminateRoutingRoutingServiceProvider에 의해 서비스 컨테이너에 등록됩니다(자세한 내용은 애플리케이션 구성 방법 참조). 🎜rrreee🎜 라우터 서비스에 해당하는 클래스는 IlluminateRoutingRouter이므로 Route Facade는 실제로 이 클래스를 나타내고 Route::get은 실제로 IlluminateRoutingRouter 객체의 get 메소드를 호출합니다🎜rrreee🎜 두 가지 추가 사항:🎜

🎜🎜파싱 서비스에 사용되는 static::$app은 초기 RegisterFacades에 설정되어 있습니다. 이는 서비스 컨테이너를 나타냅니다. 🎜🎜🎜🎜static::$app['router']; 서비스 컨테이너는 SPL의 ArrayAccess 인터페이스를 구현하므로 서비스 컨테이너에서 배열 액세스 형식으로 구문 분석할 수 있습니다. ArrayAccess 공식 문서를 읽어보실 수 있습니다 🎜🎜🎜🎜Summary🎜🎜Facade 등록 및 사용 과정을 정리해보면 Facade와 서비스 제공자(ServiceProvider)가 긴밀하게 조율되어 있음을 알 수 있으므로, 직접 Laravel 커스텀 서비스를 작성하시면 앞으로는 컴포넌트의 ServiceProvider를 통해 서비스를 등록하는 것 외에도 서비스 컨테이너에서 애플리케이션이 작성한 사용자 정의 서비스에 쉽게 액세스할 수 있도록 컴포넌트에 Facade를 제공할 수도 있습니다. 🎜🎜위 내용은 이 글의 전체 내용입니다. 모든 분들의 학습에 도움이 되었으면 좋겠습니다. 더 많은 관련 내용은 PHP 중국어 홈페이지를 주목해주세요! 🎜🎜관련 추천: 🎜

Laravel 미들웨어 해석(Middleware)


Laravel 라우팅(Route) 해석

위 내용은 Laravel 핵심 해석 파사드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!