Laravelのリアルタイムファサードの仕組みをソースコードを読みながら説明します

<?php

namespace App\Http\Controllers;

// 通常は「GuzzleHttp\Client」とする所を、
// 頭に「Facades\」をつけて、
// 「Facades\GuzzleHttp\Client」として読み込む。
use Facades\GuzzleHttp\Client;

class HomeController extends Controller
{
    public function index()
    {
        // 通常は以下のように、Guzzleクライアントのインスタンスを生成する
        // $client = new Client();
        // $res = $client->request('GET', 'http://google.com');

        // リアルタイムファサードにすることで、
        // Guzzleのインスタンスを生成せずにメソッドを静的関数のように呼び出すことができる。
        $res = Client::request('GET', 'http://google.com');
        dd($res);
    }
}

ーーー 実行結果
GuzzleHttp\Psr7\Response {#313 ▼
  -reasonPhrase: "OK"
  -statusCode: 200
  -headers: array:12 [▶]
  -headerNames: array:12 [▶]
  -protocol: "1.1"
  -stream: GuzzleHttp\Psr7\Stream {#311 ▶}
}

<?php

namespace Illuminate\Support\Facades;

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

~前略~
    public function registerCoreContainerAliases()
    {
        foreach ([
~略~
            'cache'  => [\Illuminate\Cache\CacheManager::class, \Illuminate\Contracts\Cache\Factory::class],
~攻略~

use Illuminate\Support\Facades\Facade;

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

<?php

namespace App\Http\Controllers;

use Facades\GuzzleHttp\Client;

class HomeController extends Controller
{
    public function index()
    {
        $res = Client::request('GET', 'http://google.com');
        dd($res);
    }
}

Laravelアプリケーションディレクトリ
┗ storage/
  ┗ framework/
    ┗ cache/
      ┗ facade-8f4eb59ea777457dbec43c1ed1324c3f744b1e6c.php

<?php

namespace Facades\GuzzleHttp;

use Illuminate\Support\Facades\Facade;

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

<?php

namespace Illuminate\Foundation;

class AliasLoader
{
～略～
    /**
     * The namespace for all real-time facades.
     *
     * @var string
     */
    protected static $facadeNamespace = 'Facades\\';

～略～

    /**
     * Laravel起動時にオートローダーに登録される処理。
     */
    public function load($alias)
    {
        // $facadeNamespaceは「'Facades\\'」という値になっています。
        // 渡された$aliasが「Facades\」で始まっていたら「loadFacade()」を呼び出します。
        // 「loadFacade()」リアルタイムファサード用のオートローディング処理になります。
        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);
        }
    }

    /**
     * 指定されたエイリアスのリアルタイムファサードを読み込みます。
     */
    protected function loadFacade($alias)
    {
        require $this->ensureFacadeExists($alias);
    }

    /**
     * リアルタイムファサードクラスを作ってパスを返します。
     * 既にファイルがあったら作らずにパスを返します。
     */
    protected function ensureFacadeExists($alias)
    {
        // エイリアス名（namespace名）のsha1ハッシュ値を生成してファイル名として使っています。
        // storage_path()はLaravelアプリケーションstorageディレクトリ以降のパス名を生成します。
        // file_exists()ですでにファイルが存在するか確認し、
        // すでにファイルがあればここで生成した$pathを返して終わります。
        if (file_exists($path = storage_path('framework/cache/facade-'.sha1($alias).'.php'))) {
            return $path;
        }

        // 「facade.stub」はファサードクラスのテンプレートのテキストファイルです。
        // このテンプレートを元に、リアルタイムファサードクラスを作ります。
        file_put_contents($path, $this->formatFacadeStub(
            $alias,
            file_get_contents(__DIR__.'/stubs/facade.stub')
        ));

        return $path;
    }

    /**
     * facade.stubを元にリアルタイムファサードクラスを生成します。
     * facade.stub内の文字列を以下のように置き換えます。
     * 「DummyNamespace」→ ファサードにしたいクラスのnamespace
     * 「DummyClass」→ ファサードにしたいクラスのクラス名
     * 「DummyTarget」→ getFacadeAccessor()で返すクラス名
     */
    protected function formatFacadeStub($alias, $stub)
    {
        $replacements = [
            str_replace('/', '\\', dirname(str_replace('\\', '/', $alias))),
            class_basename($alias),
            substr($alias, strlen(static::$facadeNamespace)),
        ];

        return str_replace(
            ['DummyNamespace', 'DummyClass', 'DummyTarget'],
            $replacements,
            $stub
        );
    }

～略～

    /**
     * オートローダーの登録処理。
     * load()メソッドをオートローダーとして登録している。
     */
    protected function prependToLoaderStack()
    {
        spl_autoload_register([$this, 'load'], true, true);
    }
～略～
}

<?php

namespace DummyNamespace;

use Illuminate\Support\Facades\Facade;

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