Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== Класс lmbRoutes ======

Идея класса lmbRoutes заключается в том, чтобы получать массив именованных параметров из строки посредством применения определенных паттернов (route) к данной строке и наоборот - из массива параметрв формировать строку. В качестве строки обычно используется URL, таким образом lmbRoutes обычно используется в [[request_dispatching|разборе Запроса]] для получения параметров.

===== lmbRoutes для разбора запроса =====

Список паттернов lmbRoutes получает в конструктор:

<code php>
    $config = array(array('path' => 'blog/',
                          'defaults' => array('controller' => 'blog',
                                              'action' => 'display')),
                    array('path' => 'blog/:year/:month/:day:',
                          'defaults' => array('controller' => 'blog',
                                              'action' => 'archive',
                                              'year' => date('Y'),
                                              'month' => $default_month = date('m'),
                                              'day' => $default_day = date('d')),
                          'requirements' => array('year' => '/(19|20)\d\d/',
                                                  'month' => '/[01]?\d/',
                                                  'day' => '/[0-3]?\d/')),
                    array('path' => 'blog/:action:.html',
                          'defaults' => array('service' => 'Blog',
                                              'action' => 'display')));

$routes = new lmbRoutes($config);
</code>

Список паттернов (конфиг) - это обычный массив, каждый элемент которого - один **паттерн**. Паттерн состоит из секций:
  * **path**, который указывает сам паттерн, 
  * **defaults**, где указываются значения по-умолчанию параметров, которые можно получить из паттерна, 
  * **requirements**, которые указывают на регулярные значения, которые должны выполняться для некоторых параметров, чтобы паттерн мог считаться подходящим для строки, пришедшей в метод dispatch($url).

То есть, при использовании указанного конфига, на вызов:
<code php>
    $result = $routes->dispatch('/blog/edit.html');
</code>
сработает последний роут из списка, и в $result попадут следующие параметры:
<code php>
  array('controller' => 'blog',
        'action' => 'edit')
</code>

И более сложный пример:
<code php>
    $result = $routes->dispatch('/blog/2004/12');
</code>
будет означать получение следующих параметров в $result:
<code php>
  array('controller' => 'blog',
        'action' => 'archive',
        'year' => 2004,
        'month' => 12,
        'day' => XX ); // текущий день, так как будет использовано default значение параметра.
</code>
===== lmbRoutes доступен через lmbToolkit =====

По-умолчанию объект класса lmbRoutes доступен через lmbToolkit при помощи метода getRoutes(), который добавляется в lmbToolkit через [[limb3:ru:packages:web_app:lmb_web_app_tools|lmbWebAppTools]]:

<code php>
  $routes = lmbToolkit :: instance()->getRoutes();
  $params = $routes->dispatch('/news/archive');
</code>

Объект класса lmbRoutes, получаемый через lmbToolkit, конфигурируются при помощи содержимого файла **routes.conf.php**, который обычно хранится в папке /settings. Вот пример содержимого такого файла:

<code php>
<?php
$conf = array(array('path' => '/:controller/:action',
                    'defaults' => array('controller' => 'news',
                                        'action' => 'display')),
             array('path' => '/:controller/:action/:id',
                    'defaults' => array('action' => 'display')));
?>
</code>
===== lmbRoutes для составления URL-ов =====

Итак, lmbRoutes :: **dispatch($url)** используется для получения массива параметров по строке.

Существует также обратная операция: lmbRoutes :: **toUrl($params, $route = ' ')**.

Второй параметр метода toUrl - это название паттерна. То есть паттерны могуть быть именованными, например:
<code php>
    $config = array('default' => array('path' => '/:controller/display',
                          'defaults' => array('action' => 'display')),
                     'full' => array('path' => '/:controller/:action',
                          'defaults' => array('action' => 'display')));
   $routes = new lmbRoutes($config); 
</code>

Если имя паттерна **$route** не указано, lmbRoutes пытается угадать, какой паттерн больше всего подходит. Если ни один паттерн нельзя применить, тогда генерится исключительная ситуация (exception).

Для вызова метода toUrl объекта класса lmbRoutes, который доступен через lmbToolkit, существует алиас:

<code php>
 $url = lmbToolkit :: instance()->getRoutesUrl($params, $route_name = '', $skip_controller = false));
</code>

Этот алиас используется в тегах [[limb3:ru:packages:wact:tags:lmb_request_tags:lmb_route_url_tag|<route_url>]] и [[limb3:ru:packages:wact:tags:lmb_request_tags:lmb_route_url_set_tag|<route_url_set>]], при помощи которых можно составлять url-ы из параметров прямо в шаблоне.

Параметр $route_name позволяет указать имя маршрута явно. **$skip_controller** нужен для того, чтобы отменить добавление имени текущего контроллера в список параметров, что делает тулкит по-умолчанию. Это важно, если например, маршрут не содержит такого параметра controller или содержит его в списке defaults.

Детали работы класса lmbRoutes см. в тестах lmbRoutesDispatchTest.class.php и lmbRoutesToUrlTest.class.php

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

   __ __ ______  _   __  _____   ___ 
  / //_//_  __/ | | / / / ___/  / _ |
 / ,<    / /    | |/ / / (_ /  / __ |
/_/|_|  /_/     |___/  \___/  /_/ |_|

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы