TraceableUrlMatcher
class TraceableUrlMatcher extends UrlMatcher
TraceableUrlMatcher помогает отладить сопоставление пути, отслеживая процесс сопоставления.
Постоянные значения
| REQUIREMENT_MATCH | |
| REQUIREMENT_MISMATCH | |
| ROUTE_MATCH | |
| ROUTE_DOES_NOT_MATCH | |
| ROUTE_ALMOST_MATCHES | |
| ROUTE_MATCHES |
Свойства
| protected | $context | из UrlMatcher | |
| protected | $allow | Собирает HTTP-методы, которые разрешены для запроса. | из UrlMatcher |
| protected | $allowSchemes | Собирает схемы URI, которые разрешены для запроса. | из UrlMatcher |
| protected | $routes | из UrlMatcher | |
| protected | $request | из UrlMatcher | |
| protected | $expressionLanguage | из UrlMatcher | |
| protected ExpressionFunctionProviderInterface[] | $expressionLanguageProviders | из UrlMatcher | |
| protected | $traces |
Методы
| __construct(RouteCollection $routes, RequestContext $context) | из UrlMatcher | |
| setContext(RequestContext $context) Устанавливает контекст запроса. | из UrlMatcher | |
| RequestContext | getContext() Получает контекст запроса. | из UrlMatcher |
| массив | match(string $pathinfo) Пытается сопоставить URL-путь с набором маршрутов. | из UrlMatcher |
| массив | matchRequest(Request $request) Пытается сопоставить запрос с набором маршрутов. | из UrlMatcher |
| addExpressionLanguageProvider(ExpressionFunctionProviderInterface $provider) | из UrlMatcher | |
| массив | matchCollection(string $pathinfo, RouteCollection $routes) Пытается сопоставить URL с набором маршрутов. | |
| массив | getAttributes(Route $route, string $name, array $attributes) Возвращает массив значений для использования в качестве атрибутов запроса. | из UrlMatcher |
| массив | handleRouteRequirements(string $pathinfo, string $name, Route $route) Обрабатывает конкретные требования к маршруту. | из UrlMatcher |
| массив | mergeDefaults(array $params, array $defaults) Получает объединённые значения по умолчанию. | из UrlMatcher |
| getExpressionLanguage() | из UrlMatcher | |
| createRequest($pathinfo) | из UrlMatcher | |
| getTraces($pathinfo) | ||
| getTracesForRequest(Request $request) |
Подробности
__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, он недоступен в сопоставителях, у которых нет доступа к экземпляру сопоставленного маршрута (например, в дамперах сопоставителей 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 |
getTraces($pathinfo)
Параметры
| $pathinfo |
getTracesForRequest(Request $request)
Параметры
| Request | $request |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Routing/Matcher/TraceableUrlMatcher.html
