Класс CakeRoute
Один маршрут, используемый маршрутизатором для сопоставления запросов с картами параметров.
Обычно не создается как самостоятельный. Используйте Router::connect(), чтобы создать маршруты для вашего приложения.
Прямые подклассы
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Routing/Route/CakeRoute.php
Краткое описание свойств
-
$_compiledRouteprotectedКомпилированное регулярное выражение маршрутаstring -
$_greedyprotectedstringЯвляется ли этот маршрут жадным? Жадные маршруты содержат
/*в своей шаблоне -
$_headerMapprotectedСокращенная карта HTTP-заголовков. Используется для оценки выражений маршрута, основанных на заголовках.array -
$defaultspublicПараметры по умолчанию для маршрутаarray -
$keyspublicarrayМассив именованных сегментов в маршруте.
/:controller/:action/:idсодержит 3 ключевых элемента -
$optionspublicМассив дополнительных параметров для маршрута.array -
$templatepublicСтрока шаблона маршрута.string
Краткое описание методов
- __construct() publicКонструктор маршрута
- Метод магического состояния для поддержки var_export
- _matchNamed() protectedПроверка соответствия именованного параметра текущим правилам.
- _parseArgs() protected
Разбор переданных и именованных параметров в список переданных аргументов и хеш именованных параметров. Будут использованы локальные и глобальные конфигурации для именованных параметров.
- _writeRoute() protectedПостроение регулярного выражения маршрута.
- _writeUrl() protectedПреобразование массива соответствующего маршрута в строку URL.
- compile() publicКомпиляция регулярного выражения маршрута.
- compiled() publicПроверка, был ли маршрут скомпилирован в регулярное выражение.
- match() publicПроверка, соответствует ли массив URL этому экземпляру маршрута.
- parse() publicПроверка, может ли данный URL быть распарсен этим маршрутом.
- persistParams() public
Применение постоянных параметров к массиву URL. Постоянные параметры — специальный ключ, используемый при создании маршрута для принудительной передачи параметров маршрута при их отсутствии в массиве URL.
Подробное описание методов
__construct()source public
__construct( string $template , array $defaults array() , array $options array() )
Конструктор маршрута
Параметры
- string
$template - Строка шаблона с заполнительми параметров
- array
$defaultsoptional array() - Массив значений по умолчанию для маршрута.
- array
$optionsoptional array() - Массив дополнительных опций для маршрута
__set_state()source public static
__set_state( array $fields )
Метод магического состояния для поддержки var_export
Этот метод полезен для приложений, которые хотят реализовать кэширование маршрутизатора.
Параметры
- array
$fields - Ключ/Значение атрибутов объекта
Возвращает
CakeRouteНовый экземпляр маршрута
_matchNamed()source protected
_matchNamed( string $val , array $rule , string $context )
Проверка соответствия именованного параметра текущим правилам.
Возвращает true, если заданный именованный $param's $val соответствует заданному $rule в зависимости от $context. В настоящее время реализуемые типы правил — controller, action и match, которые можно комбинировать друг с другом.
Параметры
- string
$val - Значение именованного параметра
- array
$rule - Применяемое(ые) правило(а), также может быть строкой match
- string
$context - Массив с дополнительной контекстной информацией (контроллер/действие)
Возвращает
boolean_parseArgs()source protected
_parseArgs( string $args , string $context )
Разбор переданных и именованных параметров в список переданных аргументов и хеш именованных параметров. Будут использованы локальные и глобальные конфигурации для именованных параметров.
Параметры
- string
$args - Строка с переданными и именованными параметрами. Пример: /1/page:2
- string
$context - Текущий контекст маршрута, который должен содержать ключи контроллера/действия.
Возвращает
arrayМассив ($pass, $named)
_writeRoute()source protected
_writeRoute( )
Построение регулярного выражения маршрута.
Использует свойства шаблона, значений по умолчанию и опций для компиляции регулярного выражения, которое можно использовать для парсинга строк запроса.
_writeUrl()source protected
_writeUrl( array $params )
Преобразование массива соответствующего маршрута в строку URL.
Собирает строку URL, используя шаблон, использованный при создании маршрута.
Параметры
- array
$params - Параметры для преобразования в строку URL.
Возвращает
stringСгенерированная строка маршрута.
compile()source public
compile( )
Компиляция регулярного выражения маршрута.
Изменяет свойство defaults таким образом, что все необходимые ключи устанавливаются, и заполняет $this->names именованными элементами маршрутизации.
Возвращает
arrayВозвращает строку регулярного выражения скомпилированного маршрута.
compiled()source public
compiled( )
Проверка, был ли маршрут скомпилирован в регулярное выражение.
Возвращает
booleanmatch()source public
match( array $url )
Проверка, соответствует ли массив URL этому экземпляру маршрута.
Если URL соответствует параметрам и настройкам маршрута, то возвращается сгенерированная строка URL. Если URL не соответствует параметрам маршрута, будет возвращено false. Этот метод обрабатывает обратную маршрутизацию или преобразование массивов URL в строки URL.
Параметры
- array
$url - Массив параметров для проверки соответствия.
Возвращает
mixedСтрока URL параметров, если они соответствуют, или false.
parse()source public
parse( string $url )
Проверка, может ли данный URL быть распарсен этим маршрутом.
Если маршрут может быть распарсен, будет возвращен массив параметров; в противном случае — false. Строки URL анализируются, если они соответствуют регулярному выражению маршрута.
Параметры
- string
$url - URL для попытки парсинга.
Возвращает
mixedЛогическое значение false при ошибке, в противном случае массив параметров
persistParams()source public
persistParams( array $url , array $params )
Применение постоянных параметров к массиву URL. Постоянные параметры — это специальный ключ, используемый при создании маршрута, чтобы заставить параметры маршрута сохраняться, когда они отсутствуют в массиве URL.
Параметры
- массив
$url - Массив, к которому нужно применить постоянные параметры.
- массив
$params - Массив постоянных значений для замены постоянных значений.
Возвращаемое значение
массивМассив с примененными постоянными параметрами.
Подробности свойств
$_greedysource
protected строка
Является ли этот маршрут жадным? Жадные маршруты имеют /* в своём шаблоне
false
$_headerMapsource
protected массив
Карта сокращений HTTP-заголовков. Используется для оценки выражений маршрута, основанных на заголовках.
array(
'type' => 'content_type',
'method' => 'request_method',
'server' => 'server_name'
) $keyssource
public массив
Массив именованных сегментов в маршруте. /:controller/:action/:id имеет 3 ключевых элемента
array()
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.9/class-CakeRoute.html