Spec-Zone.ru › CakePHP 2.8

Класс CakeRoute

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

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

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

  • PluginShortRoute
  • RedirectRoute
Пакет: Cake\Routing\Route
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Routing/Route/CakeRoute.php

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

  • $_compiledRoute protected
    string
    Скомпилированное регулярное выражение маршрута
  • $_greedy protected
    string

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

  • $_headerMap protected
    array
    Сокращенная карта HTTP-заголовков. Используется для оценки выражений маршрута на основе заголовков.
  • $defaults public
    array
    Параметры по умолчанию для маршрута
  • $keys public
    array

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

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

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

  • __construct() public
    Конструктор маршрута
  • __set_state() public static
    Магический метод установки состояния для поддержки 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() )

Конструктор маршрута

Параметры

строка $template
Строка-шаблон с заполнительми параметров
массив $defaults необязательно array()
Массив значений по умолчанию для маршрута.
массив $options необязательно array()
Массив дополнительных опций для маршрута

__set_state()source public static

__set_state( array $fields )

Магический метод установки состояния для поддержки var_export

Этот метод помогает приложениям, которые хотят реализовать кэширование маршрутизатора.

Параметры

массив $fields
Ключ/Значение атрибутов объекта

Возвращает

CakeRoute
Новый экземпляр маршрута

_matchNamed()source protected

_matchNamed( string $val , array $rule , string $context )

Проверка соответствия именованного параметра текущим правилам.

Возвращает true, если заданное значение параметра $param's $val соответствует заданному правилу $rule в зависимости от $context. В настоящее время реализованы типы правил: контроллер, действие и соответствие, которые могут быть объединены друг с другом.

Параметры

строка $val
Значение именованного параметра
массив $rule
Применяемые правило(а), также может быть строкой соответствия
строка $context
Массив с дополнительной контекстной информацией (контроллер/действие)

Возвращает

boolean

_parseArgs()source protected

_parseArgs( string $args , string $context )

Разбор переданных и именованных параметров в список переданных аргументов и хеш именованных параметров. Будут использоваться локальные и глобальные настройки для именованных параметров.

Параметры

строка $args
Строка с переданными и именованными параметрами. Например, /1/page:2
строка $context
Текущий контекст маршрута, который должен содержать ключи контроллер/действие.

Возвращает

массив
Массив ($pass, $named)

_writeRoute()source protected

_writeRoute( )

Создание регулярного выражения маршрута.

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

_writeUrl()source protected

_writeUrl( array $params )

Преобразование массива сопоставленного маршрута в строку URL.

Компонует строку URL, используя шаблон, используемый для создания маршрута.

Параметры

массив $params
Параметры для преобразования в строку URL.

Возвращает

строка
Сгенерированная строка маршрута.

compile()source public

compile( )

Компиляция регулярного выражения маршрута.

Изменяет свойство defaults, чтобы все необходимые ключи были установлены, и заполняет $this->names именованными элементами маршрутизации.

Возвращает

массив
Возвращает строку-регулярное выражение скомпилированного маршрута.

compiled()source public

compiled( )

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

Возвращает

boolean

match()source public

match( array $url )

Проверка соответствия массива URL данному экземпляру маршрута.

Если URL соответствует параметрам и настройкам маршрута, возвращается сгенерированная строка URL. Если URL не соответствует параметрам маршрута, возвращается false. Этот метод обрабатывает обратное маршрутизирование или преобразование массивов URL в строки URL.

Параметры

массив $url
Массив параметров для проверки соответствия.

Возвращает

смешанное
Строка URL для параметров, если они совпадают, или false.

parse()source public

parse( string $url )

Проверка, может ли данный URL быть обработан данным маршрутом.

Если маршрут может быть обработан, возвращается массив параметров; в противном случае возвращается false. Строки URL анализируются, если они соответствуют регулярному выражению маршрута.

Параметры

строка $url
URL для попытки анализа.

Возвращает

смешанное
Логическое значение false при ошибке, в противном случае массив параметров
END_OF_DOCUMENT_MARKER

persistParams()source public

persistParams( array $url , array $params )

Применение постоянных параметров к массиву URL. Постоянные параметры — это специальный ключ, используемый при создании маршрута, чтобы принудительно сохранять параметры маршрута, когда они отсутствуют в массиве URL.

Параметры

массив $url
Массив, к которому нужно применить постоянные параметры.
массив $params
Массив постоянных значений, которые нужно заменить существующими.

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

массив
Массив с применёнными постоянными параметрами.

Подробное описание свойств

$_compiledRoutesource

protected строка

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

null

$_greedysource

protected строка

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

false

$_headerMapsource

protected массив

Карта сокращений HTTP-заголовков. Используется для оценки выражений маршрута, основанных на заголовках.

array(
    'type' => 'content_type',
    'method' => 'request_method',
    'server' => 'server_name'
)

$defaultssource

public массив

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

array()

$keyssource

public массив

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

array()

$optionssource

public массив

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

array()

$templatesource

public строка

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

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/2.8/class-CakeRoute.html

Spec-Zone.ru

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