以 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 協議》,轉載必須註明作者和本文連結