Laravel 服務提供者和門面模式

紙牌屋弗蘭克發表於2017-11-06

以 Laravel 自帶的檔案系統為例,在 config/app.php 的配置檔案的 providers 陣列中,註冊了一個服務提供者:

Illuminate\Filesystem\FilesystemServiceProvider::class,

在 alias 陣列中定義了一個門面:

‘File’ => Illuminate\Support\Facades\File::class,

透過這兩個步驟,我們就可以非常方便的使用 Laravel 提供的檔案系統相關的操作,而且呼叫形式很簡潔,如:

File::exist($path),判斷檔案是否存在。

File::get($path, $lock = false),獲取一個檔案的內容。

File::append($path, $data),把內容追加到一個檔案末尾。

File::files($directory),獲取一個目錄下所有檔案。

那麼這是如何做到的呢?下面分別講一講 Laravel 的服務提供者和門面模式。

服務提供者

先看看定義:

服務提供者是所有 Laravel 應用程式啟動的中心所在。包括你自己的應用程式,以及所有的 Laravel 核心服務,都是透過服務提供者啟動的。

在檔案系統這個服務提供者中,位置 /vendor/laravel/framework/src/Illuminate/Filesystem/FilesystemServiceProvider.php,register 方法可以看到繫結了一個單例:

protected function registerNativeFilesystem()
{
    $this->app->singleton('files', function () {
        return new Filesystem;
    });
}

這個單例是 Filesystem 這個類的單例模式。當然,這個服務提供者中也可以繫結其他的單例,或做更多的事情。我們這裡只研究 File::exist() 這種呼叫方式的原理。

那麼這樣一來就有個 files 的單例,實際上是 Filesystem 這個類的例項。

此時,如果沒有 Facade,也是可以呼叫到 Filesystem 這個例項的方法的,那就是這樣呼叫:

app(‘files’)->exist($path)

好了,現在開始講 Facade.

Facade 門面模式

先看下簡介:

Facades /fəˈsäd/ 為應用程式的服務容器中可用的類提供了一個「靜態」介面。Laravel 自帶了許多的 facades,可以用來訪問其幾乎所有的服務。Laravel facades 就是服務容器裡那些基類的「靜態代理」,相比於傳統的靜態方法呼叫,facades 在提供更簡潔且豐富的語法的同時,還有更好的可測試性和擴充套件性。

本文一開始講到 alias 陣列定義了一個 File,具體的類是

Illuminate\Support\Facades\File::class,

它的內容是:

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

它實際上返回了一個名稱,注意這個名稱 files,不就是剛剛繫結的單例模式的名稱嗎?沒錯。

這樣一來,就可以使用 File 這個別名或者說門面,來呼叫這個 Filesystem 例項中的方法了。

透過本文,希望大家能夠了解服務提供者,Facade,和實際呼叫的類的例項之間的關係。

(原文地址:https://blog.tanteng.me/2017/11/laravel-fa...

本作品採用《CC 協議》,轉載必須註明作者和本文連結

相關文章