array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'yaf-route-regex.construct.php', 1 => 'Yaf_Route_Regex::__construct', 2 => 'Инициализирует новый экземпляр класса Yaf_Route_Regex', ), 'up' => array ( 0 => 'class.yaf-route-regex.php', 1 => 'Yaf_Route_Regex', ), 'prev' => array ( 0 => 'yaf-route-regex.assemble.php', 1 => 'Yaf_Route_Regex::assemble', ), 'next' => array ( 0 => 'yaf-route-regex.route.php', 1 => 'Yaf_Route_Regex::route', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/yaf/yaf_route_regex/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Yaf_Route_Regex::__construct

(Yaf >=1.0.0)

Yaf_Route_Regex::__construct — Инициализирует новый экземпляр класса Yaf_Route_Regex

Описание

public Yaf_Route_Regex::__construct(
    string $match,
    array $route,
    array $map = ?,
    array $verify = ?,
    string $reverse = ?
)

Список параметров

match

Регулярное выражение для проверки соответствия URI запроса шаблону. При несовпадении URI объект Yaf_Route_Regex вернёт значение false.

route

Массив с правилами построения маршрута. При совпадении URI запроса с шаблоном объект Yaf_Route_Regex построит маршрут и направит запрос в модуль, контроллер и (или) действие.

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

map

Массив для назначения имён совпадениям, которые захватил шаблон в результате сопоставления.

verify

reverse

Строка для обратной сборки URL-адреса методом Yaf_Route_Regex::assemble().

Замечание:

Параметр доступен с Yaf 2.3.0.

Возвращаемые значения

Примеры

Пример #1 Пример работы с классом Yaf_Route_Regex

<?php

/**
* Добавить в стек маршрутизатора Yaf_RouterПример маршрут на основе регулярного выражения
*/
Yaf_Dispatcher::getInstance()->getRouter()->addRoute(
"name",
new Yaf_Route_Regex(
"#^/product/([^/]+)/([^/])+#", // Соответствует URI запроса, который начинается с "/product"
array(
'controller' => "product", // Маршрут к контроллеру продукта
),
array(
1 => "name", // Вызов $request->getParam("name") теперь вернёт первое совпадение, которое захватил шаблон
2 => "id",
)
)
);

Пример #2 Пример работы с классом Yaf_Route_Regex с версии 2.3.0

<?php

/**
* Обработать результат совпадения как имя MCA
*/
Yaf_Dispatcher::getInstance()->getRouter()->addRoute(
"name",
new Yaf_Route_Regex(
"#^/product/([^/]+)/([^/])+#i", // Соответствует URI запроса, который начинается с "/product"
array(
'controller' => ":name", // Маршрут к контроллеру, название которого получил заменитель :name
// в результате захвата совпадения $1
),
array(
1 => "name", // Вызов $request->getParam("name") вернёт первое захваченное шаблоном совпадение
2 => "id",
)
)
);

Пример #3 Пример работы с классом Yaf_Route_Regex с версии 2.3.0

<?php

/**
* Обработать результат совпадения как имя MCA
*/
Yaf_Dispatcher::getInstance()->getRouter()->addRoute(
"name",
new Yaf_Route_Regex(
"#^/product/(?<name>[^/]+)/([^/])+#i", // Соответствует URI запроса, который начинается с "/product"
array(
'controller' => ":name", // Маршрут к контроллеру, название которого получил заменитель :name
// в результате захвата совпадения $1
),
array(
2 => "id",
)
)
);

Пример #4 Пример работы с классом Yaf_Route_Regex

<?php

/**
* Добавить в стек маршрутизатора Yaf_Router маршрут на основе регулярного выражения
* путём вызова метода addConfig
*/
$config = array(
"name" => array(
"type" => "regex", // Маршрут Yaf_Route_Regex
"match" => "#(.*)#", // Совпадение с произвольным URI запроса
"route" => array(
'controller' => "product", // Маршрут к контроллеру продукта
'action' => "dummy", // Маршрут к бессмысленному действию
),
"map" => array(
1 => "uri", // Вызов $request->getParam("uri") теперь вернёт URI запроса
),
),
);

Yaf_Dispatcher::getInstance()->getRouter()->addConfig(
new Yaf_Config_Simple($config)
);

Смотрите также