Начало работы с FigDice

<div fig:plug="pageContent">Lorem ipsum...</div> указывает, что мы должны «вставить» контент в «слот» под названием pageContent , который, как вы помните, мы создали в layout.html .

Наконец, давайте определим действительно простой маршрут для отображения страницы:

 $app->get('/', function () use ($view) { $view->loadFile( '../templates/home.html' ); return $view->render(); }); 

Работа с данными

В традиционном подходе MVC контроллер извлекает, собирает и затем «вводит» данные в представления. Подразумевается, что это означает, что контроллер должен знать, какие данные требуются и какие представления им интересны.

FigDice использует другой подход. Вместо того чтобы полагаться на контроллер для обработки данных, представления отвечают за «извлечение» данных, которые им требуются.

Для этого FigDice использует каналы . Фид — это класс, который расширяет figdice\Feed и должен содержать метод run() для возврата соответствующих данных.

Чтобы продемонстрировать это, давайте создадим блок, который отображает последние твиты пользователя на каждой странице.

Если вы посмотрите на макет, вы увидите, что мы уже добавили следующую строку, чтобы включить его:

 <fig:include file="tweets.html" /> 

На самом деле, получение твитов из API Twitter довольно просто, но выходит за рамки этой статьи — так что давайте подделать. Вот канал:

 <?php namespace Sitepoint\Feed; use figdice\Feed; class TwitterFeed extends Feed { public function run() { return array( array( 'body' => 'This is an example of a Tweet, though it isn\'t really a Tweet', ), array( 'body' => 'This is another example of a Tweet, though it isn\'t really a Tweet either', ), array( 'body' => 'Using REAL Tweets is left as an example, you see', ), ); } } 

Для простоты мы возвращаем только твиты.

Теперь давайте создадим шаблон, который «извлекает» данные из класса TwitterFeed и отображает их, используя простой неупорядоченный список:

 // file: twitter.html <?xml version="1.0" encoding="utf-8"?> <fig:template xmlns:fig="http://figdice.org/"> <fig:feed class="TwitterFeed" target="tweets" /> <ul> <li fig:walk="tweets" fig:text="body" /> </ul> </fig:template> 

Объявление <fig:feed> указывает, что мы должны создать экземпляр TwitterFeed и сделать его данные доступными с помощью ключевых tweets .

Затем мы создаем простой неупорядоченный список. Каждая итерация <fig:walk> создает элемент <li> когда он «проходит» по данным, присвоенным переменной tweets . Атрибут fig:text указывает, что текстовое содержимое тега <li> должно быть заполнено с использованием body каждого твита.

Вот результат:

 <ul> <li>This is an example of a Tweet, though it isn't really a Tweet</li> <li>This is another example of a Tweet, though it isn't really a Tweet either</li> <li>Using REAL Tweets is left as an example, you see</li> </ul> 

Фабрика

Мы еще не совсем там; для того, чтобы использовать каналы, вам понадобится фабрика . Фабрика должна реализовать \figdice\FeedFactory , которая требует, чтобы она включала метод create отвечающий за создание экземпляра данного класса фида.

Вот пример, который довольно понятен:

 <?php namespace Sitepoint\Factory; use Sitepoint\Feed\TwitterFeed; class FeedFactory implements \figdice\FeedFactory { /** * In this simple example, we did not declare additional * arguments for our factory. You can experiment by yourself. */ public function __construct() { } /** * In this simple example, we did not pass attributes to * the fig:feed invokation. * Had we specify XML attributes (in addition to class and target), * they would be interpreted by the Expression engine, and passed * as the $attribute argument, as key/value pairs. * @see \figdice\FeedFactory::create() */ public function create($className, array $attributes) { if ($className == 'TwitterFeed') { return new TwitterFeed(); } // Explicitly return null when our Factory cannot handle // the requested class, so that more Factories can chain // the lookup. return null; } } 

Делая это таким образом, вместо return new $classname , нам не нужно загрязнять наш код представления информацией о пространстве имен.

Поскольку мы используем фиктивные данные, хранящиеся в массиве, это все, что нам нужно. Однако в действительности ваша фабрика, вероятно, выполнит некоторую дополнительную инициализацию, такую ​​как регистрация соединений с базой данных или передача некоторых параметров конфигурации.

Наконец, чтобы заставить это работать, вам нужно зарегистрировать его в вашем View:

 $view->registerFeedFactory(new FeedFactory()); 

Если вы перейдете на домашнюю страницу приложения, вы должны увидеть список твитов.

Резюме

Наше фиктивное приложение теперь имеет базовую структуру, и мы рассмотрели возможность извлечения данных путем реализации простого потока Twitter, хотя и с использованием фиктивных данных.

В следующей части мы добавим наш простой веб-сайт, добавив блог, который позволит нам более подробно рассмотреть каналы данных в Figdice. Мы также предоставим выбор языка, исследуя функцию локализации Figdice.