Класс PluginShortRoute

Сокращённый маршрут плагина, копирующий параметр плагина в параметры контроллера. Используется для поддержки маршрутов /{plugin}.

Пространство имён: Cake\Routing\Route

Константы

string

PLACEHOLDER_REGEX
```
'#\\{([a-z][a-z0-9-_]*)\\}#i'
```
Регулярное выражение для соответствия заменённым участкам в шаблоне маршрута.
array<string>

VALID_METHODS
```
['GET', 'PUT', 'POST', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD']
```
Допустимые HTTP-методы.

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

$_compiledRoute protected

string|null

Компилированное регулярное выражение маршрута
$_extensions protected

array<string>

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

bool

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

bool

Флаг для отслеживания, были ли значения по умолчанию склонены.
$_name protected

string|null

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

bool

Отслеживает, были ли использованы ключи в фигурных скобках {var}.
$defaults public

array

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

array

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

array

Список мидлверов, которые должны быть применены.
$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.
_underscore() protected

Вспомогательный метод для добавления нижних подчёркиваний к ключам в массиве URL.
_writeRoute() protected

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

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

Компилирует регулярное выражение маршрута.
compiled() public

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

Получить поддерживаемые расширения для данного маршрута.
getMiddleware() public

Получить имена мидлверов, которые должны быть применены к данному маршруту.
getName() public

Получение стандартного имени plugin.controller:action для маршрута.
hostMatches() public

Проверка соответствия хоста требованиям маршрута.
match() public

Обратный поиск сокращённых URL плагинов. Если плагин и контроллер не совпадают, соответствие автоматически отклоняется.
normalizeAndValidateMethods() protected

Нормализация имён методов к верхнему регистру и проверка на то, что они являются допустимыми HTTP-методами.
parse() public

Разбор строки URL в массив. Если ключ плагина найден, он будет скопирован в параметр контроллера.
parseRequest() public

Проверка возможности разбора данного URL этим маршрутом.
setExtensions() public

Установка поддерживаемых расширений для этого маршрута.
setHost() public

Установление требования к хосту
setMethods() public

Установление принятых HTTP-методов для этого маршрута.
setMiddleware() public

Установка имён мидлверов, которые должны быть применены к этому маршруту.
setPass() public

Установка имён параметров, которые будут преобразованы в параметры перехода.
setPatterns() public

Установка регулярных выражений для параметров маршрутизации.
setPersist() public

Установка имён параметров, которые будут автоматически сохранены.
staticPath() public

Получение статической части пути для данного маршрута.

END_OF_DOCUMENT_MARKER

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

__construct() public

__construct(string $template, array $defaults = [], array<string, mixed> $options = [])

Конструктор для маршрута

Параметры

_ext - Определяет расширения, используемые для этого маршрута.
_middleware - Определяет имена middleware для этого маршрута.
pass - Копирует перечисленные параметры в params['pass'].
_method - Определяет HTTP-метод(ы), к которому относится маршрут. Может быть строкой или массивом допустимых имён HTTP-методов.
_host - Определяет шаблон имени хоста, если этот маршрут должен соответствовать только определённым именам хостов. Можно использовать .* и для создания поддоменов/хостов с подстановкой, например, *.example.com соответствует всем поддоменам на example.com.
'_port` - Определяет порт, если этот маршрут должен соответствовать только определённому номеру порта.
'_urldecode' - Устанавливается в false для отключения декодирования URL перед обработкой маршрута.

Параметры

string $template: Строка шаблона с заполнительми параметров
array $defaults optional: Значения по умолчанию для маршрута.
array<string, mixed> $options optional: Массив дополнительных параметров для маршрута

Исключения

InvalidArgumentException
При `$options['_method']` не в списке `VALID_METHODS`.

__set_state() public static

__set_state(array<string, mixed> $fields): static

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

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

Параметры

array<string, mixed> $fields: Ключ/Значение атрибутов объекта

Возвращает

static

_matchMethod() protected

_matchMethod(array $url): bool

Проверка соответствия HTTP-метода URL.

Параметры

array $url: Массив для генерируемого URL.

Возвращает

bool

_parseArgs() protected

_parseArgs(string $args, array $context): array<string>

Разбор переданных параметров в список переданных аргументов.

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

Параметры

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

Возвращает

array<string>

_parseExtension() protected

_parseExtension(string $url): array

Удаляет расширение из $url, если он содержит зарегистрированное расширение. Если зарегистрированное расширение не найдено, расширение не возвращается, и URL возвращается без изменений.

Параметры

string $url: URL для разбора.

Возвращает

array

_persistParams() protected

_persistParams(array $url, array $params): array

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

Параметры

array $url: Массив для применения постоянных параметров.
array $params: Массив постоянных значений для замены постоянных.

Возвращает

array

_underscore() protected

_underscore(array $url): array

Вспомогательный метод для подчеркивания ключей в массиве URL.

Параметры

array $url: Массив ключей URL.

Возвращает

array

_writeRoute() protected

_writeRoute(): void

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

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

Возвращает

void

_writeUrl() protected

_writeUrl(array $params, array $pass = [], array $query = []): string

Преобразует соответствующий массив маршрута в строку URL.

Составление строки URL с использованием шаблона, используемого для создания маршрута.

Параметры

array $params: Параметры для преобразования в строковый URL
array $pass optional: Дополнительные переданные аргументы
array $query optional: Массив параметров

Возвращает

string

compile() public

compile(): string

hostMatches(string $host): bool

Проверка соответствия имени хоста требованиям маршрута

Параметры

string $host: Имя хоста запроса

Возвращает

bool

match() public

match(array $url, array $context = []): string|null

Обратный маршрут плагина shortcut URL. Если плагин и контроллер не совпадают, совпадение — автоматическое отказ.

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

Параметры

array $url: Массив параметров для преобразования в строку.
array $context optional: Массив текущего контекста запроса. Содержит информацию, такую как текущий хост, схема, порт и базовый каталог.

Возвращает

string|null

normalizeAndValidateMethods() protected

normalizeAndValidateMethods(array<string>|string $methods): array<string>|string

Нормализует имена методов до верхнего регистра и проверяет, являются ли они допустимыми HTTP-методами.

Параметры

array<string>|string $methods: Методы.

Возвращает

array<string>|string

Исключения

InvalidArgumentException
При методах, не в списке `VALID_METHODS`.

parse() public

parse(string $url, string $method = ''): array|null

Разбирает строковый URL в массив. Если найден ключ плагина, он будет скопирован в параметр контроллера.

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

Параметры

string $url: URL для разбора
string $method optional: HTTP-метод

Возвращает

array|null

parseRequest() public

parseRequest(Psr\Http\Message\ServerRequestInterface $request): array|null

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

Если маршрут можно разобрать, возвращается массив параметров; в противном случае возвращается null.

Параметры

Psr\Http\Message\ServerRequestInterface $request: URL для попытки разбора.

Возвращает

array|null

setExtensions() public

setExtensions(array<string> $extensions): $this

Установите поддерживаемые расширения для этого маршрута.

Параметры

array<string> $extensions: Расширения для установки.

Возвращает

$this

setHost() public

setHost(string $host): $this

Установить требование к хосту

Параметры

string $host: Имя хоста, к которому привязан этот маршрут

Возвращает

$this

setMethods() public

setMethods(array<string> $methods): $this

Установите принятые HTTP-методы для этого маршрута.

Параметры

array<string> $methods: Принимаемые HTTP-методы.

Возвращает

$this

Исключения

InvalidArgumentException
При методах, которые не находятся в списке `VALID_METHODS`.

setMiddleware() public

setMiddleware(array $middleware): $this

Установите имена промежуточного ПО, которые должны применяться к этому маршруту.

Параметры

array $middleware: Список имён промежуточного ПО для применения к этому маршруту. Имена промежуточного ПО не будут проверены, пока маршрут не будет сопоставлен.

Возвращает

$this

setPass() public

setPass(array<string> $names): $this

Установите имена параметров, которые будут преобразованы в параметры перехода.

Параметры

array<string> $names: Имена параметров, которые должны быть переданы.

Возвращает

$this

setPatterns() public

setPatterns(array<string> $patterns): $this

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

Если какие-либо из ваших шаблонов содержат многобайтовые значения, будет включён режим multibytePattern.

Параметры

array<string> $patterns: Шаблоны, применяемые к элементам маршрутизации

Возвращает

$this

setPersist() public

setPersist(array $names): $this

Установите имена параметров, которые будут автоматически сохранены.

Сохраняемые параметры позволяют определить, какие параметры маршрута должны быть автоматически включены при создании новых URL-адресов. Вы можете переопределить сохраняемые параметры, переопределяя их в URL-адресе или удалить их, установив сохраняемый параметр в false.

// remove a persistent 'date' parameter
Router::url(['date' => false', ...]);

Параметры

array $names: Имена параметров, которые должны быть переданы.

Возвращает

$this

staticPath() public

staticPath(): string

Получить статическую часть пути для этого маршрута.

Возвращает

string

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

`$_inflectedDefaults` protected

Тип

string

© 2005–present 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/4.3/class-Cake.Routing.Route.PluginShortRoute.html