Как создать фасад в Laravel 4

Статистика: Символов — 4 360/3 695 без пробелов (1 635/1 394 без кода):, слов — 242
Разметка: Wiki
Есть три компонента при создания фасада:
  1. **Корень фасада** (Facade Root) - базовый класс, методы которого вызывает фасад.
  2. **Класс фасада**, который указывает Laravel, к какому зарегистрированному (базовому) классу он относится.
  3. **Сервис-провайдер**, который регистрирует базовый класс в контейнере приложения (%%App%%).

== Сценарий использования ==
Предположим, у нас есть класс, для которого мы хотим сгенерировать фасад. Например, класс %%Fideloper\Example\UnderlyingClass%%.
%%
<?php namespace Fideloper\Example;

class UnderlyingClass {

    public function doSomething()
    {
        echo 'Doing something!';
    }

}
%%

Теперь предположим, что мы хотим создать такой фасад для этого класса, который позволит разработчикам получать доступ к нему с помощью таких вызовов:
%%
UnderlyingClass::doSomething();
%%

== Реализация ==
Сначала вам надо создать класс фасада:
%%
<?php namespace Fideloper\Example\Facades;

use Illuminate\Support\Facades\Facade;

class UnderlyingClass extends Facade {

    /**
     * Получить зарегистрированное имя компонента.
     *
     * @return string
     */
    protected static function getFacadeAccessor() { return 'underlyingclass'; }

}
%%

Возвращая %%(t)underlyingclass%% из метода-доступа фасада, мы даем понять Laravel, что класс фасада ищет %%$app['underlyingclass']%%.

Далее вам надо соединить ваш базовый класс с вашим фасадом. Это можно сделать с помощью сервис-провайдера, который сделает две вещи:
  1. Привяжет %%(t)underlyingclass%% к нашему объекту %%UnderlyingClass%%. Как уже упоминалось выше, это соединит идентификатор фасада %%(t)underlyingclass%% с привязанным %%$app['underlyingclass']%%.
  2. Создаст псевдоним, используемый для доступа к базовому классу %%UnderlyingClass%%. Этот псевдоним зарегистрирован для созданного нами фасада, который в свою очередь настроен на доступ к нашему базовому классу. Понятно? Хорошо. **Примечание:** установка псевдонима в сервис-провайдере - это создание ярлыка, поэтому вам не надо беспокоиться о добавлении записи в псевдонимы в %%(t)app/config/app.php%%. На мой взгляд, добавление псевдонима в сервис-провайдере проще для разработчиков - просто подключите сервис-провайдер в %%(t)app/config/app.php%% и продолжайте работу!

Вот сервис-провайдер:
%%
<?php namespace Fideloper\Example;

use Illuminate\Support\ServiceProvider;

class ExampleServiceProvider extends ServiceProvider {

    /**
     * Регистрация сервис-провайдера.
     *
     * @return void
     */
    public function register()
    {
        // Регистрация экземпляра контейнера 'underlyingclass' для нашего объекта UnderlyingClass
        $this->app['underlyingclass'] = $this->app->share(function($app)
        {
            return new Fideloper\Example\UnderlyingClass;
        });

        // Создание ярлыка, разработчикам не надо добавлять псевдоним в app/config/app.php
        $this->app->booting(function()
        {
            $loader = \Illuminate\Foundation\AliasLoader::getInstance();
            $loader->alias('UnderlyingClass', 'Fideloper\Example\Facades\UnderlyingClass');
        });
    }
}
%%

Последний шаг - зарегистрируйте ваш сервис-провайдер в файле %%(t)app/config/app.php%% вместе с другими провайдерами, и вы сможете использовать ваш новый фасад!
%%
'providers' => array(

    ... Прочие провайдеры выше ...
    'Illuminate\Workbench\WorkbenchServiceProvider',

    'Fideloper\Example\ExampleServiceProvider',

),
%%

Вот и всё! Вы можете использовать ваш фасад как того и хотели:
%%
UnderlyingClass::doSomething();
%%