Шаблоны и отклики

Статистика: Символов — 7 057/5 994 без пробелов (3 957/3 391 без кода):, слов — 567
Разметка: Wiki
{{TOC}}

{{DOCVER 4.0=0da300f6445bec5a70d007f503834fce957b065b 16.10.2014 5:19:26, 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03, 4.2=d7b13440c003218ed79e9d508706eca01990122f 4.12.2014 5:01:15}}

== Базовые отклики ==
**Возврат строк из ((docs/v4/routing маршрутов))**
%%
  Route::get('/', function () {
    return 'Привет, мир!';
  });
%%

**Создание собственного ответа (отклика)**

Объект %%Response%% наследует класс %%Symfony\Component\HttpFoundation\Response%%, который предоставляет набор методов для построения отклика HTTP.
%%
  $response = Response::make($contents, $statusCode);

  $response->header('Content-Type', $value);

  return $response;
%%

%%(DOCNEW 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03)
Если вам нужен доступ к методам класса %%Response%%, но вы хотите возвращать шаблон в качестве содержимого отклика, то вы можете использовать метод %%Response::view%% для удобства:
~%%
  return Response::view('hello')->header('Content-Type', $type);
~%%
%%
**Добавление cookie к ответу**
%%
  $cookie = Cookie::make('name', 'значение');

  return Response::make($content)->withCookie($cookie);
%%

== Переадресация ==
%%
  return Redirect::to('user/login');
%%

**Переадресация с одноразовыми переменными сессии**
%%
  return Redirect::to('user/login')->with('message', 'Войти не удалось');
%%

.(alert)
Метод %%with()%% сохраняет данные в сессии, поэтому вы можете прочитать их, используя обычный метод %%Session::get()%%.

**Переадресация на ((docs/v4/routing#именованны+е))й маршрут**
%%
  return Redirect::route('login');
%%

**Переадресация на ((docs/v4/routing#именованны+е))й маршрут с параметрами**
%%
  return Redirect::route('profile', array(1));
%%

**Переадресация на ((docs/v4/routing#именованны+е))й маршрут с именованными параметрами**
%%
  return Redirect::route('profile', array('user' => 1));
%%

**Переадресация на действие ((docs/v4/controllers контроллера))**
%%
  return Redirect::action('HomeController@index');
%%

**Переадресация на действие ((docs/v4/controllers контроллера)) с параметрами**
%%
  return Redirect::action('UserController@profile', array(1));
%%

**Переадресация на действие ((docs/v4/controllers контроллера)) с именованными параметрами**
%%
  return Redirect::action('UserController@profile', array('user' => 1));
%%

== Шаблоны ==
Шаблоны (//views//) обычно содержат HTML-код вашего приложения и представляют собой удобный способ разделения логики контроллеров и обработки страниц от их представления. Шаблоны хранятся в папке %%(t)app/views%%.

Простой шаблон может иметь такой вид:
%%(html)
  <!-- Шаблон из файла app/views/greeting.php -->

  <html>
      <body>
          <h1>Привет, <?php echo $name; ?></h1>
      </body>
  </html>
%%

Этот шаблон может быть возвращён в браузер таким образом:
%%
  Route::get('/', function () {
    return View::make('greeting', array('name' => 'Тейлор'));
  });
%%

Второй параметр, переданный в %%View::make()%% - массив данных, которые должны быть доступны внутри шаблона.

**Передача переменных в шаблон**
%%
  // Используя традиционный подход
  $view = View::make('greeting')->with('name', 'Стив');

  // Используя магию
  $view = View::make('greeting')->withName('стив');
%%

В примере выше переменная %%$name%% будет доступна в шаблоне и будет иметь значение %%(t)Стив%%.

Можно передать массив данных в виде второго параметра для метода %%make()%%:
%%
  $view = View::make('greetings', $data);
%%

Вы также можете "поделить" данные между всеми шаблонами, сделав их глобальными:
%%
  View::share('name', 'Steve');
%%

**Передача вложенного шаблона в шаблон**

Иногда вам может быть нужно передать шаблон внутрь другого шаблона. Например, имея шаблон %%(t)app/views/child/view.php%% нам может понадобиться передать его в другой шаблон и мы можем сделать это так:
%%
  $view = View::make('greeting')->nest('child', 'child.view');

  $view = View::make('greeting')->nest('child', 'child.view', $data);
%%

Затем вложенный шаблон может быть отображён в родительском шаблоне:
%%(html)
  <html>
      <body>
          <h1>Привет!</h1>
          <?php echo $child; ?>
      </body>
  </html>
%%

%%(DOCNEW 4.2=d7b13440c003218ed79e9d508706eca01990122f 4.12.2014 5:01:15)
**Определение существования шаблона**

Для определения того, существует ли шаблон, используйте метод %%View::exists()%%:
~%%
  if (View::exists('emails.customer'))
  {
    //
  }
~%%
%%

== Составители ==
Составители шаблонов - функции обратного вызова или методы класса, которые вызываются, когда данный шаблон формируется (отображается) в строку. Если у вас есть данные, которые вы хотите привязать к шаблону при каждом его формировании, то составители помогут вам выделить такую логику в единое место. Таким образом, составители могут работать как "модели шаблонов" или "представители".

**Регистрация составителя**
%%
  View::composer('profile', function ($view) {
    $view->with('count', User::count());
  });
%%

Теперь при каждом отображении шаблона %%(t)profile%% к нему будет привязана переменная %%(t)count%%.

Вы можете привязать составитель сразу к нескольким шаблонам:
%%
  View::composer(array('profile','dashboard'), function ($view) {
    $view->with('count', User::count());
  });
%%

Если вам больше нравятся методы классов, что позволяет вам использовать регистрации в ((docs/v4/ioc контейнере IoC)), то вы можете сделать это так:
%%
  View::composer('profile', 'ProfileComposer');
%%

Класс составителя должен иметь такой вид:
%%
  class ProfileComposer {

    public function compose($view)
    {
      $view->with('count', User::count());
    }

  }
%%

%%(DOCNEW 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03)
**Регистрация нескольких составителей**

Вы можете использовать метод %%composers()%%, чтобы зарегистрировать группу составителей за один раз:
~%%
  View::composers(array(
    'AdminComposer' => array('admin.index', 'admin.profile'),
    'UserComposer' => 'user',
    'ProductComposer@create' => 'product' 
  ));
~%%
%%

.(alert)
Нет строгого правила, где должны храниться классы-составители. Вы можете поместить их в любое место, где их сможет найти автозагрузчик в соответствии с директивами в вашем файле %%(t)composer.json%%.

== Создатели ==
Создатели шаблонов работают почти так же, как ((#составители)), но вызываются сразу после создания объекта шаблона, а не во время его отображения в строку.Для регистрации нового создателя используйте метод %%View::creator()%%:
%%
  View::creator('profile', function ($view) {
    $view->with('count', User::count());
  });
%%

== Особые отклики ==
**Создание JSON-ответа**
%%
  return Response::json(array('name' => 'Стив', 'state' => 'CA'));
%%

**Создание ((ВП:JSONP))-ответа**
%%
  return Response::json(array('name' => 'Стив', 'state' => 'CA'))
    ->setCallback(Input::get('callback'));
%%

**Создание отклика загрузки файла**
%%
  return Response::download($pathToFile);

  return Response::download($pathToFile, $name, $headers);
%%

.(alert)
Класс Symfony %%HttpFoundation%%, которая управляет загрузкой файлов, требует, чтобы загружаемый файл имел ASCII-имя.

%%(DOCNEW 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03)
== Макрос отклика ==
Если вы хотите зарегистрировать пользовательский отклик, который вы смогли бы использовать повторно в различных маршрутах и контроллерах, то можете использовать метод %%Response::macro()%%:
~%%
  Response::macro('caps', function($value)
  {
    return Response::make(strtoupper($value));
  });
~%%

Функция %%macro()%% принимает имя в качестве первого аргумента и замыкание в качестве второго. Замыкание макроса будет выполнено при вызове имени макроса на классе %%Response%%:
~%%
  return Response::caps('foo');
~%%

Вы можете зарегистрировать свои макросы в одном из ваших файлов %%(t)app/start%%. Или вы можете организовать свои макросы в отдельном файле, который будет подключаться в одном из старт-файлов.
%%