Как работают фасады Laravel и как их использовать в других местах

Шаблон Facade — это шаблон проектирования программного обеспечения, который часто используется в объектно-ориентированном программировании. Фактически фасад — это класс, заключающий в себе сложную библиотеку, чтобы обеспечить более простой и читаемый интерфейс. Шаблон Facade также можно использовать для предоставления унифицированного и хорошо разработанного API для группы сложных и плохо разработанных API.

Каркас Laravel имеет особенность, похожую на этот рисунок, также называемую Фасады. В этом уроке мы узнаем, как перенести «Фасады» Ларавеля в другие рамки. Прежде чем мы продолжим, вы должны иметь общее представление о контейнерах Ioc .

Давайте сначала пройдемся по внутренним рабочим частям фасадов Laravel, а затем обсудим, как мы можем адаптировать эту функцию к другим средам.

Фасады в Ларавеле

Фасад Laravel — это класс, который предоставляет статический интерфейс для служб внутри контейнера. Эти фасады, согласно документации, служат прокси для доступа к базовой реализации сервисов контейнера.

Однако в сообществе PHP было много споров об этом именовании . Некоторые утверждают, что этот термин следует изменить, чтобы избежать путаницы среди разработчиков, поскольку он не полностью реализует шаблон Facade. Если это название вас смущает, не стесняйтесь называть его так, как считаете нужным, но учтите, что базовый класс, который мы собираемся использовать, называется Facade в среде Laravel.

Как Фасады реализованы в Laravel

Как вы, наверное, знаете, каждый сервис внутри контейнера имеет уникальное имя. В приложении Laravel для доступа к сервису напрямую из контейнера мы можем использовать метод App::make() или вспомогательную функцию app() .

 <? php App :: make ( 'some_service' )-> methodName (); 

Как упоминалось ранее, Laravel использует классы фасадов, чтобы сделать сервисы доступными для разработчика более читабельным способом. Используя класс фасадов, нам нужно было бы написать следующий код, чтобы сделать то же самое:

 // ... someService :: methodName (); 
 // ... 

В Laravel все сервисы имеют класс фасадов. Эти классы фасадов расширяют базовый класс Facade, который является частью пакета Illuminate/Support . Единственное, что им нужно реализовать, — это метод getFacadeAccessor , который возвращает имя службы внутри контейнера.

В приведенном выше синтаксисе someService ссылается на класс фасада. methodName фактически является методом исходного сервиса в контейнере. Если мы посмотрим на этот синтаксис вне контекста Laravel, это будет означать, что есть класс с именем someService представляющий статический метод с именем methodName() , но это не то, как Laravel реализует этот интерфейс. В следующем разделе мы увидим, как работает базовый класс Facade Laravel за кулисами.

Базовый Фасад

Класс Facade имеет частное свойство с именем $app котором хранится ссылка на контейнер службы. Если нам нужно использовать фасады вне Laravel, мы должны явно установить контейнер с помощью setFacadeApplication() . Мы вернемся к этому в ближайшее время.

Внутри базового класса фасада был реализован магический метод __callStatic для обработки вызова статических методов, которые на самом деле не существуют. Когда мы вызываем статический метод для класса фасада Laravel, вызывается метод __callStatic, потому что класс фасада не реализовал этот метод. Следовательно, __callStatic извлекает соответствующую услугу из контейнера и вызывает метод против него.

Вот реализация метода __callStatic в базовом классе фасада:

 <? php // ... 
 /** * Handle dynamic, static calls to the object. * * @param string $method * @param array $args * @return mixed */ 
     public   static   function  __callStatic ( $method ,  $args ) 
     { $instance =   static :: getFacadeRoot (); 

         switch   ( count ( $args ))   { 
             case   0 : 
                 return  $instance -> $method (); 

             case   1 : 
                 return  $instance -> $method ( $args [ 0 ]); 

             case   2 : 
                 return  $instance -> $method ( $args [ 0 ],  $args [ 1 ]); 

             case   3 : 
                 return  $instance -> $method ( $args [ 0 ],  $args [ 1 ],  $args [ 2 ]); 

             case   4 : 
                 return  $instance -> $method ( $args [ 0 ],  $args [ 1 ],  $args [ 2 ],  $args [ 3 ]); 

             default : 
                 return  call_user_func_array ([ $instance ,  $method ],  $args ); 
         } 
     } 

В приведенном выше методе getFacadeRoot() получает сервис из контейнера.

 <? php namespace   App \Facades ; 

 use   Illuminate \Support\Facades\Facade as   BaseFacade ; 

 class   SomeServiceFacade   extends   BaseFacade   { 

     /** * Get the registered name of the component. * * @return string */ 
     protected   static   function  getFacadeAccessor ()   {   return   'some.service' ;   } 

 } 

 use   App \Facades\SomeServiceFacade SomeServiceFacade : SomeMethod (); 

 // .. 
 'aliases'   =>   [ 
     // ... 
     'FancyName'   =>   'App\Facades\SomeServiceFacade' , 
 ], 

 <? php // FancyName is resolved to App\Facades\SomeServiceFacade according to the aliases array 

 FancyName :: someMethod () 

 <? php $app [ 'some.service' ]-> someMethod () 

 <? php SomeService :: someMethod (); 

 composer require illuminate\support 

 <? php namespace   App \Facades use   Illuminate \Support\Facades\Facade ; 

 class   SomeServiceFacade   extends   Facade   { 

     /** * Get the registered name of the component. * * @return string */ 
     protected   static   function  getFacadeAccessor ()   {   return   'some.service' ;   } 

 } 

 <? php Illumiante \Support\Facade :: setFacadeApplication ( $app ); 

 <? php return   [ 
     'FancyName'   =>   'App\Facades\SomeService' , 
 ]; 

 <? php // ... $aliases =   require  __DIR__ .   '/../../config/aliases.php' ; 
 App \Facades\AliasLoader :: getInstance ( $aliases )-> register (); 

 <? php FancyName :: methodName ();