TraceableUrlMatcher
extends UrlMatcher
in package
TraceableUrlMatcher helps debug path info matching by tracing the match.
Tags
Table of Contents
- REQUIREMENT_MATCH = 0
- REQUIREMENT_MISMATCH = 1
- ROUTE_ALMOST_MATCHES = 1
- ROUTE_DOES_NOT_MATCH = 0
- ROUTE_MATCH = 2
- ROUTE_MATCHES = 2
- $allow : mixed
- $context : mixed
- $expressionLanguage : mixed
- $expressionLanguageProviders : array<string|int, ExpressionFunctionProviderInterface>
- $request : mixed
- $routes : mixed
- $traces : mixed
- __construct() : mixed
- addExpressionLanguageProvider() : mixed
- getContext() : mixed
- {@inheritdoc}
- getTraces() : mixed
- getTracesForRequest() : mixed
- match() : array<string|int, mixed>
- Tries to match a URL path with a set of routes.
- matchRequest() : array<string|int, mixed>
- Tries to match a request with a set of routes.
- setContext() : mixed
- {@inheritdoc}
- getAttributes() : array<string|int, mixed>
- Returns an array of values to use as request attributes.
- getExpressionLanguage() : mixed
- handleRouteRequirements() : array<string|int, mixed>
- Handles specific route requirements.
- matchCollection() : array<string|int, mixed>
- Tries to match a URL with a set of routes.
- mergeDefaults() : array<string|int, mixed>
- Get merged default parameters.
- addTrace() : mixed
Constants
REQUIREMENT_MATCH
public
mixed
REQUIREMENT_MATCH
= 0
REQUIREMENT_MISMATCH
public
mixed
REQUIREMENT_MISMATCH
= 1
ROUTE_ALMOST_MATCHES
public
mixed
ROUTE_ALMOST_MATCHES
= 1
ROUTE_DOES_NOT_MATCH
public
mixed
ROUTE_DOES_NOT_MATCH
= 0
ROUTE_MATCH
public
mixed
ROUTE_MATCH
= 2
ROUTE_MATCHES
public
mixed
ROUTE_MATCHES
= 2
Properties
$allow
protected
mixed
$allow
= []
$context
protected
mixed
$context
$expressionLanguage
protected
mixed
$expressionLanguage
$expressionLanguageProviders
protected
array<string|int, ExpressionFunctionProviderInterface>
$expressionLanguageProviders
= []
$request
protected
mixed
$request
$routes
protected
mixed
$routes
$traces
protected
mixed
$traces
Methods
__construct()
public
__construct(RouteCollection $routes, RequestContext $context) : mixed
Parameters
- $routes : RouteCollection
- $context : RequestContext
Return values
mixed —addExpressionLanguageProvider()
public
addExpressionLanguageProvider(ExpressionFunctionProviderInterface $provider) : mixed
Parameters
- $provider : ExpressionFunctionProviderInterface
Return values
mixed —getContext()
{@inheritdoc}
public
getContext() : mixed
Return values
mixed —getTraces()
public
getTraces(mixed $pathinfo) : mixed
Parameters
- $pathinfo : mixed
Return values
mixed —getTracesForRequest()
public
getTracesForRequest(Request $request) : mixed
Parameters
- $request : Request
Return values
mixed —match()
Tries to match a URL path with a set of routes.
public
match(mixed $pathinfo) : array<string|int, mixed>
Parameters
- $pathinfo : mixed
-
The path info to be parsed (raw format, i.e. not urldecoded)
Return values
array<string|int, mixed> —An array of parameters
matchRequest()
Tries to match a request with a set of routes.
public
matchRequest(Request $request) : array<string|int, mixed>
Parameters
- $request : Request
Return values
array<string|int, mixed> —An array of parameters
setContext()
{@inheritdoc}
public
setContext(RequestContext $context) : mixed
Parameters
- $context : RequestContext
Return values
mixed —getAttributes()
Returns an array of values to use as request attributes.
protected
getAttributes(Route $route, string $name, array<string|int, mixed> $attributes) : array<string|int, mixed>
As this method requires the Route object, it is not available in matchers that do not have access to the matched Route instance (like the PHP and Apache matcher dumpers).
Parameters
- $route : Route
-
The route we are matching against
- $name : string
-
The name of the route
- $attributes : array<string|int, mixed>
-
An array of attributes from the matcher
Return values
array<string|int, mixed> —An array of parameters
getExpressionLanguage()
protected
getExpressionLanguage() : mixed
Return values
mixed —handleRouteRequirements()
Handles specific route requirements.
protected
handleRouteRequirements(string $pathinfo, string $name, Route $route) : array<string|int, mixed>
Parameters
- $pathinfo : string
-
The path
- $name : string
-
The route name
- $route : Route
-
The route
Return values
array<string|int, mixed> —The first element represents the status, the second contains additional information
matchCollection()
Tries to match a URL with a set of routes.
protected
matchCollection(mixed $pathinfo, RouteCollection $routes) : array<string|int, mixed>
Parameters
- $pathinfo : mixed
-
The path info to be parsed
- $routes : RouteCollection
-
The set of routes
Return values
array<string|int, mixed> —An array of parameters
mergeDefaults()
Get merged default parameters.
protected
mergeDefaults(array<string|int, mixed> $params, array<string|int, mixed> $defaults) : array<string|int, mixed>
Parameters
- $params : array<string|int, mixed>
-
The parameters
- $defaults : array<string|int, mixed>
-
The defaults
Return values
array<string|int, mixed> —Merged default parameters
addTrace()
private
addTrace(mixed $log[, mixed $level = self::ROUTE_DOES_NOT_MATCH ][, mixed $name = null ][, mixed $route = null ]) : mixed
Parameters
- $log : mixed
- $level : mixed = self::ROUTE_DOES_NOT_MATCH
- $name : mixed = null
- $route : mixed = null