摘要：使用現(xiàn)在，在任何一個(gè)控制器，或者路由的回調(diào)函數(shù)中，使用你會(huì)發(fā)現(xiàn)，已經(jīng)可以好好工作了，參考文章設(shè)計(jì)模式九外觀模式結(jié)構(gòu)型服務(wù)容器實(shí)例教程深入理解控制反轉(zhuǎn)和依賴注入服務(wù)提供者實(shí)例教程創(chuàng)建測(cè)試實(shí)例

我的博客原文: http://www.qinblog.net/Articl...

laravel 提供了一個(gè)靈活的模式，那就是 facade ?？蚣軆?nèi)部的 DB、Auth、File 等功能也有相關(guān)的 facade 實(shí)現(xiàn)。那么，該如何寫自己的 facade 呢？

首先，facade 并不是 laravel 獨(dú)有的東西，它就是設(shè)計(jì)模式中的外觀模式(Facade)。
當(dāng)然，這里就不長(zhǎng)篇大論去討論外觀模式的定義了。這篇文章寫的很不錯(cuò) ： 設(shè)計(jì)模式（九）外觀模式Facade（結(jié)構(gòu)型）。
那么，laravel 的 facade 做了什么？
同樣的， laravel 實(shí)現(xiàn)了外觀模式的開關(guān)功能，并且使用魔術(shù)方法 __callstatic 實(shí)現(xiàn)了靜態(tài)方式調(diào)用、動(dòng)態(tài)創(chuàng)建對(duì)象的功能。參考 (官方文檔)

當(dāng)然你可能覺得這些概念很抽象，都什么玩意。那么其實(shí)簡(jiǎn)單的講，laravel 的 facade 就是將某些功能封裝成工具類，而且能以靜態(tài)方式調(diào)用工具類的方法。

首先、以 laravel 5.1 框架，我之前寫過的 Geoip facade 為例，說一下怎么去建立自己的 facade。

geoip 是一個(gè)可以更具 IP 獲取國(guó)家、地域、城市信息的 PHP 擴(kuò)展，基于 maxmind 數(shù)據(jù)庫(kù)。 github 在此。

首先，為 laravel 添加 geoip 擴(kuò)展。
打開 composer.json，添加 "geoip2/geoip2": "~2.0" 到 require。
項(xiàng)目根目錄運(yùn)行 composer update ( 需要安裝 composer )更新一下，geoip 的依賴和軟件包就被下載到 vendor 文件夾中了。

然后下載 geoip 依賴的數(shù)據(jù)庫(kù)，免費(fèi)庫(kù)的地址 ： GeoLite2

我下載了 GeoLite2 Country 和 GeoLite2 City 庫(kù)，放到了 storage/geoipdb 中。

在 app 目錄下新建 Facades 文件夾，里面新建 Facades/GeoIP/GeoIP.php 和 Facades/GeoIP/Facade/GeoIP.php (建議每個(gè)功能新建一個(gè)文件夾區(qū)分，比如我這里給 GeoIP 新建一個(gè)文件夾，關(guān)于GeoIP 的東西全放到這里)
注意，F(xiàn)acades/GeoIP 下的 GeoIP.php 是你要對(duì) geoip 擴(kuò)展進(jìn)行封裝的類， Facades/GeoIP/Facade 下的 GeoIP.php 是你的 facade，用來給 laravel 解析使用，這兩個(gè)文件可以不同名。

目錄結(jié)構(gòu)如圖:

Facades/GeoIP/Facade/GeoIP.php 如下

注意你的 facade 現(xiàn)在只有一個(gè)方法，返回了一個(gè)字符串 "geoip" , 這個(gè)字符串是一個(gè)標(biāo)號(hào)，用來給 laravel 的服務(wù)提供者解析使用的。
Facades/GeoIP/GeoIP.php 如下（吐槽：寫的有點(diǎn)隨意）
_country_db;
            break;
          case "getCity":
            $path = $this->_city_db;
            break;
          default:
            break;
        }

        $this->_instance = new Reader(storage_path($path));
    }

    /**
     * Get Country infomations.
     *
     * @param  String  $ip
     * @return Array
     */
    public function getCountry($ip)
    {
      $this->init(__FUNCTION__);

      $record = $this->_instance->country($ip);

      // 國(guó)家信息
      $data["iso_code"] = $record->country->isoCode;
      $data["country_name"] = $record->country->name;
      $data["country_name_zh_cn"] = $record->country->names["zh-CN"];

      return $data;
    }
 
 /**
     * Get City infomations.
     *
     * @param  String  $ip
     * @return Array
     */
    public function getCity($ip)
    {
      $this->init(__FUNCTION__);

      $record = $this->_instance->city($ip);

      $data["iso_code"] = $record->country->isoCode;
      $data["country_name"] = $record->country->name;
      $data["country_name_zh_cn"] = $record->country->names["zh-CN"];

      // 省、州信息
      $data["sub_division_name"] = $record->mostSpecificSubdivision->name;
      $data["sub_division_name_zh_cn"] = $record->mostSpecificSubdivision->names["zh-CN"];
      $data["sub_division_code"] = $record->mostSpecificSubdivision->isoCode;

      // 城市信息
      $data["city_name"] = $record->city->name;
      $data["postal_code"] = $record->postal->code;

      // 經(jīng)緯度
      $data["latitude"] = $record->location->latitude;
      $data["longitude"] = $record->location->longitude;

      return $data;
    }

}

OK，現(xiàn)在 geoip 的常用功能已經(jīng)封裝到方法中了。
注冊(cè)服務(wù)
完成了 facade 的創(chuàng)建和功能封裝，下面就要使用它了。自己創(chuàng)建的 facade 要在 laravel 使用是要進(jìn)行注冊(cè)的，以便 laraval 在啟動(dòng)時(shí)能自動(dòng)注入依賴(請(qǐng)看 laravel 的依賴注入簡(jiǎn)介 : laravel 依賴注入 學(xué)院君)
編寫服務(wù)提供者
在 app/Providers 下新建 FacadesServiceProvider.php
可以手動(dòng)建，也可以用 artisan 命令來生成，隨你喜歡。
app/Providers/FacadesServiceProvider.php 代碼如下:
app->singleton("geoip", function ($app) {
            return new GeoIP($app);
        });
    }
}

上面代碼可知，服務(wù)提供者注冊(cè)時(shí)會(huì)注冊(cè)一個(gè)單例，標(biāo)號(hào)為 "geoip"，也就是我們自己的 facade 返回的那個(gè)，然后回調(diào)函數(shù)會(huì)返回一個(gè)對(duì)象，也就是我們封裝 geoip 功能的那個(gè)類的實(shí)例，不明白的同學(xué)可以看看 laravel 的服務(wù)提供者和服務(wù)容器相關(guān)知識(shí)哦。(注意要 use 將 facade 和封裝類的命名空間引用一下哦)
注冊(cè)服務(wù)提供者
laravel 5.1 以上版本的話， config/app.php 中找到 providers 和 aliases ，將你的服務(wù)提供者和 facade 別名配置一下 : 
providers 加入 ：
AppProvidersFacadeServiceProvider::class,
aliases 加入(不用每次都寫很長(zhǎng)的命名空間前綴) :
"GeoIP"      => AppFacadesGeoIPFacadeGeoIP::class,
對(duì)于 lumen 5.2 以上，需要在 bootstrap/app.php 中添加
$app->register(AppProvidersFacadesServiceProvider::class);
注冊(cè)完畢后，每次使用 facade::function 的時(shí)候，laravel 會(huì)自動(dòng)解析 facade， 然后創(chuàng)建一個(gè)對(duì)象給用戶使用，，而無需用戶自己去 new 一個(gè)對(duì)象出來。
使用
現(xiàn)在，在任何一個(gè)控制器，或者路由的回調(diào)函數(shù)中，使用
$res = GeoIP::getCountry("75.101.195.215");
var_dump($res);
你會(huì)發(fā)現(xiàn)，facade 已經(jīng)可以好好工作了，enjoy！
參考文章
【1】設(shè)計(jì)模式（九）外觀模式Facade（結(jié)構(gòu)型）
【2】Laravel 服務(wù)容器實(shí)例教程 —— 深入理解控制反轉(zhuǎn)（IoC）和依賴注入（DI）
【3】Laravel 服務(wù)提供者實(shí)例教程 —— 創(chuàng)建 Service Provider 測(cè)試實(shí)例