Spec-Zone.ru › CakePHP 3.3

Класс Route

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

Обычно не создается как самостоятельный. Используйте Router::connect() для создания маршрутов для вашего приложения.

Прямые подклассы

  • Cake\Routing\Route\DashedRoute
  • Cake\Routing\Route\InflectedRoute
  • Cake\Routing\Route\RedirectRoute

Косвенные подклассы

  • Cake\Routing\Route\PluginShortRoute
Пространство имен: Cake\Routing\Route
Расположение: Routing/Route/Route.php

Краткое описание свойств

  • $_compiledRoute protected
    string
    Компилированное регулярное выражение маршрута
  • $_extensions protected
    array
    Список подключенных расширений для этого маршрута.
  • $_greedy protected
    string

    Является ли этот маршрут жадным маршрутом? Жадные маршруты содержат /* в своей шаблоне

  • $_name protected
    string
    Имя маршрута. Получите с помощью Route::getName();
  • $defaults public
    array
    Параметры по умолчанию для маршрута
  • $keys public
    array

    Массив именованных сегментов в маршруте. /:controller/:action/:id имеет 3 ключевых элемента

  • $options public
    array
    Массив дополнительных параметров для маршрута.
  • $template public
    string
    Шаблон строки маршрута.

Краткое описание методов

  • __construct() public
    Конструктор маршрута
  • __set_state() public static
    Магический метод для установки состояния, поддерживающий 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
Шаблонная строка с заполнительми параметров
массив|строка $defaults optional []
Значения по умолчанию для маршрута.
массив $options optional []
Массив дополнительных опций для маршрута

__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( )

Проверяет, был ли маршрут скомпилирован в регулярное выражение.

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

boolean

extensions()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.

Возвращает

string

match()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

Подробности свойств

$_compiledRoutesource

protected string

Скомпилированное регулярное выражение маршрута

null

$_extensionssource

protected массив

Список подключенных расширений для этого маршрута.

[]

$_greedysource

protected string

Является ли этот маршрут жадным? Жадные маршруты имеют /* в своём шаблоне

false

$_namesource

protected строка

Имя маршрута. Получить с помощью Route::getName();

null

$defaultssource

public массив

Параметры по умолчанию для маршрута

[]

$keyssource

public массив

Массив именованных сегментов в маршруте. /:controller/:action/:id содержит 3 ключевых элемента

[]
END_OF_DOCUMENT_MARKER

$optionssource

public array

Массив дополнительных параметров для маршрута.

[]

$templatesource

public string

Строка шаблона маршрута.

null

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API