UrlMatcher

class UrlMatcher implements UrlMatcherInterface, RequestMatcherInterface

UrlMatcher сопоставляет URL на основе набора маршрутов.

Постоянные значения

REQUIREMENT_MATCH
REQUIREMENT_MISMATCH
ROUTE_MATCH

Свойства

protected	$context
protected	$allow	Собирает HTTP-методы, которые разрешены для запроса.
protected	$allowSchemes	Собирает URI-схемы, которые разрешены для запроса.
protected	$routes
protected	$request
protected	$expressionLanguage
protected ExpressionFunctionProviderInterface[]	$expressionLanguageProviders

Методы

	__construct(RouteCollection $routes, RequestContext $context)
	setContext(RequestContext $context) Устанавливает контекст запроса.
RequestContext	getContext() Получает контекст запроса.
array	match(string $pathinfo) Пытается сопоставить URL-путь с набором маршрутов.
array	matchRequest(Request $request) Пытается сопоставить запрос с набором маршрутов.
	addExpressionLanguageProvider(ExpressionFunctionProviderInterface $provider)
array	matchCollection(string $pathinfo, RouteCollection $routes) Пытается сопоставить URL с набором маршрутов.
array	getAttributes(Route $route, string $name, array $attributes) Возвращает массив значений, используемых в качестве атрибутов запроса.
array	handleRouteRequirements(string $pathinfo, string $name, Route $route) Обрабатывает определенные требования маршрута.
array	mergeDefaults(array $params, array $defaults) Получить объединенные параметры по умолчанию.
	getExpressionLanguage()
	createRequest($pathinfo)

Подробности

__construct(RouteCollection $routes, RequestContext $context)

Параметры

RouteCollection	$routes
RequestContext	$context

setContext(RequestContext $context)

Устанавливает контекст запроса.

Параметры

RequestContext

$context

RequestContext getContext()

Получает контекст запроса.

Значение возврата

RequestContext

Контекст

array match(string $pathinfo)

Попытка сопоставить путь URL с набором маршрутов.

Если сопоставитель не может найти информацию, он должен выбросить одно из исключений, описанных ниже.

Параметры

string

$pathinfo

Информация о пути для парсинга (сырой формат, т.е. не декодированный по URL)

Значение возврата

array

Массив параметров

Исключения

NoConfigurationException	Если не найдена конфигурация маршрутизации
ResourceNotFoundException	Если ресурс не найден
MethodNotAllowedException	Если ресурс был найден, но метод запроса не разрешен

array matchRequest(Request $request)

Попытка сопоставить запрос с набором маршрутов.

Если сопоставитель не может найти информацию, он должен выбросить одно из исключений, описанных ниже.

Параметры

Request

$request

Значение возврата

array

Массив параметров

Исключения

NoConfigurationException	Если не найдена конфигурация маршрутизации
ResourceNotFoundException	Если не найдено соответствующего ресурса
MethodNotAllowedException	Если соответствующий ресурс найден, но метод запроса не разрешен

addExpressionLanguageProvider(ExpressionFunctionProviderInterface $provider)

Параметры

ExpressionFunctionProviderInterface

$provider

protected array matchCollection(string $pathinfo, RouteCollection $routes)

Попытка сопоставить URL с набором маршрутов.

Параметры

string	$pathinfo	Информация о пути для парсинга
RouteCollection	$routes	Набор маршрутов

Значение возврата

array

Массив параметров

Исключения

NoConfigurationException	Если не найдена конфигурация маршрутизации
ResourceNotFoundException	Если ресурс не найден
MethodNotAllowedException	Если ресурс был найден, но метод запроса не разрешен

protected array getAttributes(Route $route, string $name, array $attributes)

Возвращает массив значений, которые необходимо использовать в качестве атрибутов запроса.

Поскольку этот метод требует объекта Route, он недоступен в сопоставителях, у которых нет доступа к экземпляру Route, соответствующего совпадению (например, в дамперах сопоставителей PHP и Apache).

Параметры

Route	$route	Маршрут, по которому происходит сопоставление
string	$name	Имя маршрута
array	$attributes	Массив атрибутов от сопоставителя

Значение возврата

array

Массив параметров

protected array handleRouteRequirements(string $pathinfo, string $name, Route $route)

Обрабатывает специфические требования маршрута.

Параметры

string	$pathinfo	Путь
string	$name	Имя маршрута
Route	$route	Маршрут

Значение возврата

array

Первый элемент представляет состояние, второй содержит дополнительную информацию

protected array mergeDefaults(array $params, array $defaults)

Получить объединённые параметры по умолчанию.

Параметры

array	$params	Параметры
array	$defaults	Параметры по умолчанию

Значение возврата

array

Объединённые параметры по умолчанию

protected getExpressionLanguage()

protected createRequest($pathinfo)

Параметры

$pathinfo

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Routing/Matcher/UrlMatcher.html