Класс Route
Один маршрут, используемый маршрутизатором для подключения запросов к параметрам.
Обычно не создается как самостоятельный. Используйте Router::connect() для создания маршрутов для вашего приложения.
Прямые подклассы
Косвенные подклассы
Краткое описание свойств
-
$_compiledRouteprotectedКомпилированное регулярное выражение маршрутаstring -
$_extensionsprotectedСписок подключенных расширений для этого маршрута.array -
$_greedyprotectedstringЯвляется ли этот маршрут жадным маршрутом? Жадные маршруты содержат
/*в своей шаблоне -
$_nameprotectedИмя маршрута. Получите с помощью Route::getName();string -
$defaultspublicПараметры по умолчанию для маршрутаarray -
$keyspublicarrayМассив именованных сегментов в маршруте.
/:controller/:action/:idимеет 3 ключевых элемента -
$optionspublicМассив дополнительных параметров для маршрута.array -
$templatepublicШаблон строки маршрута.string
Краткое описание методов
- __construct() publicКонструктор маршрута
- Магический метод для установки состояния, поддерживающий var_export
- _matchMethod() protectedПроверка соответствия HTTP-метода URL.
- _parseArgs() protectedРазбор переданных параметров в список переданных аргументов.
- _parseExtension() protected
Удаляет расширение из $url, если оно содержит зарегистрированное расширение. Если зарегистрированное расширение не найдено, расширение не возвращается, и URL возвращается без изменений.
- _persistParams() protected
Применение постоянных параметров к массиву URL. Постоянные параметры — это специальный ключ, используемый при создании маршрута, чтобы принудительно сохранить параметры маршрута при их отсутствии в массиве URL.
- _writeRoute() protectedСоздание регулярного выражения маршрута.
- _writeUrl() protectedПреобразование массива соответствующего маршрута в строку URL.
- compile() publicКомпиляция регулярного выражения маршрута.
- compiled() publicПроверка, скомпилирован ли маршрут в регулярное выражение.
- extensions() publicПолучение/установка поддерживаемых расширений для этого маршрута.
- getExtensions() publicПолучение поддерживаемых расширений для этого маршрута.
- getName() publicПолучение стандартного имени плагина.контроллер:действие для маршрута.
- match() publicПроверка соответствия массива URL этому экземпляру маршрута.
- parse() publicПроверка возможности парсинга данного URL этим маршрутом.
- setExtensions() publicУстановка поддерживаемых расширений для этого маршрута.
- staticPath() publicПолучение статической части пути для этого маршрута.
Детали методов
__construct()source public
__construct( string $template , array|string $defaults [] , array $options [] )
Конструктор маршрута
Опции
-
_ext- Определяет расширения, используемые для данного маршрута. -
pass- Копирует перечисленные параметры в params['pass'].
Параметры
- строка
$template - Шаблонная строка с заполнительми параметров
- массив|строка
$defaultsoptional [] - Значения по умолчанию для маршрута.
- массив
$optionsoptional [] - Массив дополнительных опций для маршрута
__set_state()source public static
__set_state( array $fields )
Магический метод для установки состояния, поддерживающий var_export
Этот метод полезен для приложений, которые хотят реализовать кэширование маршрутизатора.
Параметры
- массив
$fields - Ключи/Значения атрибутов объекта
Возвращает
Cake\Routing\Route\RouteНовый экземпляр маршрута
_matchMethod()source protected
_matchMethod( array $url )
Проверка соответствия HTTP-метода URL.
Параметры
- массив
$url - Массив для генерируемого URL.
Возвращает
boolean_parseArgs()source protected
_parseArgs( string $args , string $context )
Разбирает переданные параметры в список переданных аргументов.
Возвращает true, если заданное имя параметра $param и его значение $val соответствуют заданному правилу $rule в зависимости от контекста $context. В настоящее время реализованы типы правил: controller, action и match, которые могут быть объединены.
Параметры
- строка
$args - Строка с переданными параметрами. Например, /1/foo
- строка
$context - Текущий контекст маршрута, который должен содержать ключи controller/action.
Возвращаемое значение
массивМассив переданных аргументов.
_parseExtension()source protected
_parseExtension( string $url )
Удаляет расширение из $url, если оно содержит зарегистрированное расширение. Если зарегистрированное расширение не найдено, расширение не возвращается, и URL возвращается без изменений.
Параметры
- строка
$url - URL для разбора.
Возвращаемое значение
массивсодержащий url, расширение
_persistParams()source protected
_persistParams( array $url , array $params )
Применяет постоянные параметры к массиву URL. Постоянные параметры — это специальный ключ, используемый во время создания маршрута, чтобы принудительно сохранить параметры маршрута, когда они опущены из массива URL.
Параметры
- массив
$url - Массив, к которому следует применить постоянные параметры.
- массив
$params - Массив постоянных значений для замены постоянных.
Возвращаемое значение
массивМассив с примененными постоянными параметрами.
_writeRoute()source protected
_writeRoute( )
Создаёт регулярное выражение для маршрута.
Использует свойства template, defaults и options для компиляции регулярного выражения, которое может быть использовано для разбора строк запроса.
_writeUrl()source protected
_writeUrl( array $params , array $pass [] , array $query [] )
Преобразует массив совпавшего маршрута в строку URL.
Составной URL-строки с использованием шаблона, используемого для создания маршрута.
Параметры
- массив
$params - Параметры для преобразования в строку URL
- массив
$passнеобязательно [] - Дополнительные переданные аргументы
- массив
$queryнеобязательно [] - Массив параметров
Возвращаемое значение
строкаСозданная строка маршрута.
compile()source public
compile( )
Компилирует регулярное выражение маршрута.
Изменяет свойство defaults, чтобы установить все необходимые ключи, и заполняет $this->names именованными элементами маршрутизации.
Возвращаемое значение
массивВозвращает строку регулярного выражения скомпилированного маршрута.
compiled()source public
compiled( )
Проверяет, был ли маршрут скомпилирован в регулярное выражение.
Возвращаемое значение
booleanextensions()source public
extensions( null|string|array $extensions null )
Получение/Установка поддерживаемых расширений для данного маршрута.
Устарело
3.3.9 Используйте getExtensions/setExtensions вместо этого.Параметры
- null|string|массив
$extensionsнеобязательно null - Расширения для установки. Используйте null для получения.
Возвращаемое значение
массив|nullРасширения или null.
getExtensions()source public
getExtensions( )
Получение поддерживаемых расширений для данного маршрута.
Возвращаемое значение
массивgetName()source public
getName( )
Получить стандартизированное имя маршрута plugin.controller:action.
Возвращает
stringmatch()source public
match( array $url , array $context [] )
Проверить, соответствует ли массив URL этому экземпляру маршрута.
Если URL соответствует параметрам и настройкам маршрута, возвращается сгенерированный строковый URL. Если URL не соответствует параметрам маршрута, возвращается false. Этот метод обрабатывает обратное маршрутирование или преобразование массивов URL в строковые URL.
Параметры
- массив
$url - Массив параметров для проверки соответствия.
- массив
$contextнеобязательный [] Массив текущего контекста запроса. Содержит информацию, такую как текущий хост, схему, порт, базовый каталог и другие параметры URL.
Возвращает
string|falseСтроковый URL для параметров, если они соответствуют, или false в случае неудачи.
parse()source public
parse( string $url , string $method '' )
Проверяет, может ли данный URL быть проанализирован этим маршрутом.
Если маршрут может быть проанализирован, возвращается массив параметров; в противном случае — false. Строковые URL анализируются, если они соответствуют регулярному выражению маршрута.
Параметры
- строка
$url - URL для попытки анализа.
- строка
$methodнеобязательный '' - Метод HTTP запроса, который анализируется.
Возвращает
массив|falseМассив параметров запроса или false при неудаче.
setExtensions()source public
setExtensions( array $extensions )
Установить поддерживаемые расширения для этого маршрута.
Параметры
- массив
$extensions - Расширения для установки.
Возвращает
$this
staticPath()source public
staticPath( )
Получить статическую часть пути для этого маршрута.
Возвращает
stringПодробности свойств
$_greedysource
protected string
Является ли этот маршрут жадным? Жадные маршруты имеют /* в своём шаблоне
false
$keyssource
public массив
Массив именованных сегментов в маршруте. /:controller/:action/:id содержит 3 ключевых элемента
[]
© 2005–2017 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/3.3/class-Cake.Routing.Route.Route.html