So funktionieren Fassaden

In einer Laravel-Anwendung ist eine Fassade eine Klasse, die auf Objekte aus dem Container zugreifen kann. Die Kernkomponente ist die Klasse Facade. Ob es sich um Laravels eigene Fassaden oder benutzerdefinierte Fassaden handelt, sie alle erben von der Klasse IlluminateSupportFacadesFacade.

Facade Die Basisklasse verwendet die magische Methode __callStatic(), die erst aufgerufen wird, wenn das Objekt aus dem Container analysiert wird. Im folgenden Beispiel wird das Caching-System von Laravel aufgerufen. Beim Durchsuchen dieses Codes kann davon ausgegangen werden, dass die statische Methode Cache in der Klasse get aufgerufen wird:

<?php
   namespace App\Http\Controllers;
   use App\Http\Controllers\Controller;
   use Illuminate\Support\Facades\Cache;
   class UserController extends Controller{   
    /**
     * 显示给定用户的信息。
     *
     * @param  int  $id
     * @return Response
     */   
      public function showProfile($id) 
         {       
           $user = Cache::get('user:'.$id); 
           return view('profile', ['user' => $user]);  
          }
      }

Beachten Sie, dass wir im obigen Code die Cache-Fassade „importieren“. Diese Fassade fungiert als Proxy für den Zugriff auf die zugrunde liegende Implementierung der IlluminateContractsCacheFactory-Schnittstelle. Alle Aufrufe, die wir über die Fassade tätigen, werden an die zugrunde liegende Instanz des Laravel-Caching-Dienstes weitergeleitet.

Wenn wir uns die IlluminateSupportFacadesCache-Klasse ansehen, werden Sie feststellen, dass es in der Klasse überhaupt keine get statische Methode gibt:

class Cache extends Facade{   
    /**
     * 获取组件的注册名称。
     *
     * @return string
     */  
       protected static function getFacadeAccessor() { 
            return 'cache'; 
        }
     }

Cache Facade erbt die Facade-Klasse und definiert die getFacadeAccessor() Methode. Die Funktion dieser Methode besteht darin, den Namen der Service-Container-Bindung zurückzugeben. Wenn der Benutzer eine statische Methode in der Cache-Fassade aufruft, löst Laravel die cache-Bindung aus dem Service-Container auf und führt die angeforderte Methode für dieses Objekt aus (in diesem Fall die get-Methode).

Echtzeit-Fassaden

Mit Echtzeit-Fassaden können Sie jede Klasse in Ihrer Anwendung als eine Klasse behandeln Fassade. Um zu veranschaulichen, wie dies verwendet wird, schauen wir uns eine andere Methode an. Nehmen wir zum Beispiel an, unser Podcast-Modell verfügt über eine publish-Methode. Um jedoch einen Podcast zu veröffentlichen, müssen wir eine Publisher-Instanz einfügen:

<?php
   namespace App;
   use App\Contracts\Publisher;
   use Illuminate\Database\Eloquent\Model;
   class Podcast extends Model{  
     /**
     * 发布 Podcast。
     *
     * @param  Publisher  $publisher
     * @return void
     */ 
        public function publish(Publisher $publisher) 
           {     
              $this->update(['publishing' => now()]); 
              $publisher->publish($this);   
             }
        }

Indem wir die Implementierung des Herausgebers in die Methode einfügen, können wir diesen Ansatz leicht testen, da wir den injizierten Herausgeber verspotten können. Allerdings müssen wir jedes Mal, wenn wir die publish-Methode aufrufen, eine Herausgeberinstanz übergeben. Mit Live-Fassaden können wir die gleiche Testbarkeit aufrechterhalten, ohne Publisher Instanzen explizit übergeben zu müssen. Um ein Echtzeit-Facade zu generieren, stellen Sie die Facades im Namespace der importierten Klasse voran:

<?php
   namespace App;
   use Facades\App\Contracts\Publisher;
   use Illuminate\Database\Eloquent\Model;
   class Podcast extends Model{ 
    /**
     * 发布 Podcast。
     *
     * @return void
     */ 
        public function publish()  
          {   
               $this->update(['publishing' => now()]); 
                Publisher::publish($this);  
            }
       }

Bei Verwendung einer Echtzeit-Fassade übergibt die Herausgeberimplementierung den Schnittstellen- oder Klassennamen mithilfe von Facades Präfix, das danach erscheint. Löst das Problem des Service-Containers teilweise. Beim Testen können wir die integrierte Fassadentest-Hilfsfunktion von Laravel verwenden, um diesen Methodenaufruf zu simulieren:

<?php
  namespace Tests\Feature;use App\Podcast;
  use Tests\TestCase;use Facades\App\Contracts\Publisher;
  use Illuminate\Foundation\Testing\RefreshDatabase;
  class PodcastTest extends TestCase{  
    use RefreshDatabase;   
    /**
     * 一个测试演示。
     *
     * @return void
     */  
       public function test_podcast_can_be_published()  
         {    
             $podcast = factory(Podcast::class)->create(); 
             Publisher::shouldReceive('publish')->once()->with($podcast);  
             $podcast->publish(); 
            }
      }

Facade-Klassenreferenz

Unten finden Sie jede Facade-Klasse und die entsprechende zugrunde liegende Klasse. Dies ist ein Tool zum Auffinden der API-Dokumentation für eine bestimmte Facade-Klasse. Wichtige Informationen für Service-Container-Bindungen sind ebenfalls enthalten.