Класс RedirectRoute
Маршрут перенаправления выполнит немедленное перенаправление. Маршруты перенаправления полезны, когда вам нужно, чтобы слой маршрутизации выполнял перенаправления в вашем приложении, в случаях, когда адреса URL перемещаются.
Перенаправление сигнализируется исключением, которое останавливает сопоставление маршрутов и определяет URL перенаправления и код состояния.
- Cake\Routing\Route\Route
-
Cake\Routing\Route\RedirectRoute
Краткое описание свойств
-
$redirectpublicМесто назначения перенаправления. Строка или массив CakePHP URL.array|string - Объект Response
$responsepublic
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- match() publicОбратный маршрут для перенаправления не поддерживается.
- parse() public
Разбирает строковый URL в массив. Разбор URL приведёт к автоматическому перенаправлению.
Подробное описание методов
__construct()source public
__construct( string $template , array|string $defaults [] , array $options [] )
Конструктор
Параметры
- строка
$template - Шаблонная строка с заполнительми параметров
- массив|строка
$defaultsнеобязательно [] - Значения по умолчанию для маршрута.
- массив
$optionsнеобязательно [] - Массив дополнительных опций для маршрута
Переопределяет
Cake\Routing\Route\Route::__construct() match()source public
match( array $url , array $context [] )
Обратный маршрут для перенаправления не поддерживается.
Параметры
- массив
$url - Массив параметров для преобразования в строку.
- массив
$contextнеобязательно [] - Массив параметров контекста запроса.
Возвращает
booleanВсегда false.
Переопределяет
Cake\Routing\Route\Route::match() parse()source public
parse( string $url )
Парсит строковый URL в массив. Парсируемые URL приведут к автоматическому перенаправлению.
Параметры
- строка
$url - URL для парсинга.
Возвращает
false|nullFalse при ошибке. Исключение генерируется при успешном совпадении.
Выбрасывает
Cake\Routing\Exception\RedirectExceptionИсключение генерируется при успешном совпадении. Это используется для остановки сопоставления маршрутов и сигнализирования middleware о необходимости перенаправления.
Переопределяет
Cake\Routing\Route\Route::parse() Методы, унаследованные от Cake\Routing\Route\Route
__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's $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 )
Получение/установка поддерживаемых расширений для данного маршрута.
Параметры
- null|строка|массив
$extensionsопционально null - Расширения для установки. Использование null для получения.
Возвращает
массив|nullРасширения или null.
getName()source public
getName( )
Получение стандартного имени плагина.controller:action для маршрута.
Возвращает
строкаstaticPath()source public
staticPath( )
Получить статическую часть пути для этого маршрута.
Возвращает
строкаПодробности свойств
$redirectsource
public массив|строка
Место перенаправления. Либо строка, либо URL-адрес CakePHP в виде массива.
$responsesource
public Cake\Network\Response
Объект Response
Устарело
3.2.0 Это свойство не используется.null
© 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.
http://api.cakephp.org/3.2/class-Cake.Routing.Route.RedirectRoute.html