AbstractMatch
in package
implements
MatchInterface
Pop router match abstract class
Tags
Table of Contents
Interfaces
- MatchInterface
- Pop router match interface
Properties
- $defaultRoute : array<string|int, mixed>|null
- Default route
- $dispatchableCache : mixed
- Cached dispatchable resolution for the current match cycle
- $dispatchableParams : array<string|int, mixed>
- Dispatchable parameters
- $dispatchableResolved : bool
- Whether the dispatchable has been resolved for the current match cycle
- $dynamicRoute : mixed
- Dynamic route
- $dynamicRouteActionIndex : int|null
- Position of the ':action'/'<action>' token within the dynamic route declaration
- $dynamicRouteControllerIndex : int|null
- Position of the ':controller'/'<controller>' token within the dynamic route declaration
- $dynamicRouteLiterals : array<string|int, mixed>
- Literal segments of the dynamic route declaration, keyed by their position within that declaration
- $dynamicRoutePrefix : mixed
- Dynamic route prefix
- $isDynamicRoute : bool
- Flag for dynamic route
- $preparedRoutes : array<string|int, mixed>
- Prepared routes
- $route : string|null
- Matched route
- $routeNames : array<string|int, mixed>
- Route names
- $routeParams : array<string|int, mixed>
- Route parameters
- $routes : array<string|int, mixed>
- Routes
- $routeString : string|null
- Route string
- $segments : array<string|int, mixed>
- Segments of route string
Methods
- addDispatchableParams() : AbstractMatch
- Add dispatchable params to be passed into a new dispatchable instance
- addRoute() : AbstractMatch
- Add a route
- addRoutes() : AbstractMatch
- Add multiple controller routes
- appendDispatchableParams() : AbstractMatch
- Append dispatchable params to be passed into a new dispatchable instance
- getAction() : mixed
- Get the action
- getDefaultRoute() : array<string|int, mixed>
- Get the default route
- getDispatchable() : mixed
- Get the dispatchable
- getDispatchableParams() : mixed
- Get the params assigned to the dispatchable
- getDynamicRoute() : mixed
- Get the dynamic route
- getDynamicRoutePrefix() : mixed
- Get the dynamic route prefix
- getFlattenedRoutes() : array<string|int, mixed>
- Get flattened routes
- getOriginalRoute() : string|null
- Get original route string
- getPreparedRoutes() : array<string|int, mixed>
- Get prepared routes
- getRoute() : string
- Get route regex
- getRouteConfig() : mixed
- Get route config
- getRouteParams() : array<string|int, mixed>
- Get the params discovered from the route
- getRoutes() : array<string|int, mixed>
- Get routes
- getRouteString() : string
- Get the route string
- getSegment() : string|null
- Get a route string segment
- getSegments() : array<string|int, mixed>
- Get the route string segments
- hasAction() : bool
- Determine if there is an action
- hasDefaultRoute() : bool
- Determine if there is a default route
- hasDispatchable() : bool
- Determine if there is a dispatchable
- hasDispatchableParams() : bool
- Determine if the dispatchable has params
- hasDynamicRoute() : bool
- Determine if there is a dynamic route
- hasName() : bool
- Has a route name
- hasRoute() : bool
- Determine if the route has been matched
- hasRouteConfig() : bool
- Has route config
- hasRouteParams() : bool
- Determine if the route has params
- isDynamicRoute() : bool
- Determine if it is a dynamic route
- match() : bool
- Match the route
- name() : AbstractMatch
- Add a route name
- noRouteFound() : void
- Method to process if a route was not found
- prepare() : AbstractMatch
- Prepare the routes
- removeDispatchableParams() : AbstractMatch
- Remove dispatchable params
- getDynamicRouteParamOffset() : int
- Get the segment offset at which the dynamic route's params start, i.e. the segment right after the action token
- isDynamicRouteDeclaration() : bool
- Determine if a route declaration is the dynamic-route (":controller"/"<controller") pattern
- isDynamicRouteLiteral() : bool
- Determine if a dynamic route declaration token is a literal segment, i.e. neither a param token nor an option
- matchesDynamicRoute() : bool
- Determine if the current request matches the dynamic route declaration: every literal segment of the declaration has to line up with the request's segment in that same position, and the request has to carry a segment where the declaration puts its controller token
- normalizeController() : mixed
- Normalize a raw dispatchable value (closure, native callable, or a pop-utils pseudo-callable string such as 'Class->method', 'Class::method', 'Class', or 'new Class') into a ['controller' => $controller] config array. Already-formed config arrays (and nested-route sub-arrays) are returned unchanged.
- parseDynamicRoute() : void
- Parse a dynamic route declaration, recording where its ':controller'/':action' (HTTP) or '<controller>'/'<action>' (CLI) tokens sit within the declaration, along with any literal segments the request has to match for the route to apply
- registerDynamicRoute() : void
- Register a dynamic route
- registerRegularRoute() : mixed
- Register a regular (literal or param-bearing) route, recursing for nested route configs
- registerWildcardRoute() : mixed
- Register a wildcard/default route
Properties
$defaultRoute
Default route
protected
array<string|int, mixed>|null
$defaultRoute
= null
$dispatchableCache
Cached dispatchable resolution for the current match cycle
protected
mixed
$dispatchableCache
= null
$dispatchableParams
Dispatchable parameters
protected
array<string|int, mixed>
$dispatchableParams
= []
$dispatchableResolved
Whether the dispatchable has been resolved for the current match cycle
protected
bool
$dispatchableResolved
= false
$dynamicRoute
Dynamic route
protected
mixed
$dynamicRoute
= null
$dynamicRouteActionIndex
Position of the ':action'/'<action>' token within the dynamic route declaration
protected
int|null
$dynamicRouteActionIndex
= null
$dynamicRouteControllerIndex
Position of the ':controller'/'<controller>' token within the dynamic route declaration
protected
int|null
$dynamicRouteControllerIndex
= null
$dynamicRouteLiterals
Literal segments of the dynamic route declaration, keyed by their position within that declaration
protected
array<string|int, mixed>
$dynamicRouteLiterals
= []
$dynamicRoutePrefix
Dynamic route prefix
protected
mixed
$dynamicRoutePrefix
= null
$isDynamicRoute
Flag for dynamic route
protected
bool
$isDynamicRoute
= false
$preparedRoutes
Prepared routes
protected
array<string|int, mixed>
$preparedRoutes
= []
$route
Matched route
protected
string|null
$route
= null
$routeNames
Route names
protected
array<string|int, mixed>
$routeNames
= []
$routeParams
Route parameters
protected
array<string|int, mixed>
$routeParams
= []
$routes
Routes
protected
array<string|int, mixed>
$routes
= []
$routeString
Route string
protected
string|null
$routeString
= null
$segments
Segments of route string
protected
array<string|int, mixed>
$segments
= []
Methods
addDispatchableParams()
Add dispatchable params to be passed into a new dispatchable instance
public
addDispatchableParams(string $dispatchable, mixed $params) : AbstractMatch
Parameters
- $dispatchable : string
- $params : mixed
Return values
AbstractMatchaddRoute()
Add a route
public
addRoute(string $route, mixed $controller) : AbstractMatch
Parameters
- $route : string
- $controller : mixed
Return values
AbstractMatchaddRoutes()
Add multiple controller routes
public
addRoutes(array<string|int, mixed> $routes) : AbstractMatch
Parameters
- $routes : array<string|int, mixed>
Return values
AbstractMatchappendDispatchableParams()
Append dispatchable params to be passed into a new dispatchable instance
public
appendDispatchableParams(string $dispatchable, mixed $params) : AbstractMatch
Parameters
- $dispatchable : string
- $params : mixed
Return values
AbstractMatchgetAction()
Get the action
public
getAction() : mixed
getDefaultRoute()
Get the default route
public
getDefaultRoute() : array<string|int, mixed>
Return values
array<string|int, mixed>getDispatchable()
Get the dispatchable
public
getDispatchable() : mixed
getDispatchableParams()
Get the params assigned to the dispatchable
public
getDispatchableParams(string $dispatchable) : mixed
Parameters
- $dispatchable : string
getDynamicRoute()
Get the dynamic route
public
getDynamicRoute() : mixed
getDynamicRoutePrefix()
Get the dynamic route prefix
public
getDynamicRoutePrefix() : mixed
getFlattenedRoutes()
Get flattened routes
public
getFlattenedRoutes() : array<string|int, mixed>
Return values
array<string|int, mixed>getOriginalRoute()
Get original route string
public
getOriginalRoute() : string|null
Return values
string|nullgetPreparedRoutes()
Get prepared routes
public
getPreparedRoutes() : array<string|int, mixed>
Return values
array<string|int, mixed>getRoute()
Get route regex
public
getRoute() : string
Return values
stringgetRouteConfig()
Get route config
public
getRouteConfig([string|null $key = null ]) : mixed
Parameters
- $key : string|null = null
getRouteParams()
Get the params discovered from the route
public
getRouteParams() : array<string|int, mixed>
Return values
array<string|int, mixed>getRoutes()
Get routes
public
getRoutes() : array<string|int, mixed>
Return values
array<string|int, mixed>getRouteString()
Get the route string
public
getRouteString() : string
Return values
stringgetSegment()
Get a route string segment
public
getSegment(int $i) : string|null
Parameters
- $i : int
Return values
string|nullgetSegments()
Get the route string segments
public
getSegments() : array<string|int, mixed>
Return values
array<string|int, mixed>hasAction()
Determine if there is an action
public
hasAction() : bool
Return values
boolhasDefaultRoute()
Determine if there is a default route
public
hasDefaultRoute() : bool
Return values
boolhasDispatchable()
Determine if there is a dispatchable
public
hasDispatchable() : bool
Return values
boolhasDispatchableParams()
Determine if the dispatchable has params
public
hasDispatchableParams(string $dispatchable) : bool
Parameters
- $dispatchable : string
Return values
boolhasDynamicRoute()
Determine if there is a dynamic route
public
hasDynamicRoute() : bool
Return values
boolhasName()
Has a route name
public
hasName(string $routeName) : bool
Parameters
- $routeName : string
Return values
boolhasRoute()
Determine if the route has been matched
public
abstract hasRoute() : bool
Return values
boolhasRouteConfig()
Has route config
public
hasRouteConfig([string|null $key = null ]) : bool
Parameters
- $key : string|null = null
Return values
boolhasRouteParams()
Determine if the route has params
public
hasRouteParams() : bool
Return values
boolisDynamicRoute()
Determine if it is a dynamic route
public
isDynamicRoute() : bool
Return values
boolmatch()
Match the route
public
abstract match([string|array<string|int, mixed>|null $forceRoute = null ]) : bool
Parameters
- $forceRoute : string|array<string|int, mixed>|null = null
Return values
boolname()
Add a route name
public
name(string $routeName) : AbstractMatch
Parameters
- $routeName : string
Tags
Return values
AbstractMatchnoRouteFound()
Method to process if a route was not found
public
abstract noRouteFound([bool $exit = true ]) : void
Parameters
- $exit : bool = true
prepare()
Prepare the routes
public
abstract prepare() : AbstractMatch
Return values
AbstractMatchremoveDispatchableParams()
Remove dispatchable params
public
removeDispatchableParams(string $dispatchable) : AbstractMatch
Parameters
- $dispatchable : string
Return values
AbstractMatchgetDynamicRouteParamOffset()
Get the segment offset at which the dynamic route's params start, i.e. the segment right after the action token
protected
getDynamicRouteParamOffset() : int
Return values
intisDynamicRouteDeclaration()
Determine if a route declaration is the dynamic-route (":controller"/"<controller") pattern
protected
isDynamicRouteDeclaration(string $route) : bool
Parameters
- $route : string
Return values
boolisDynamicRouteLiteral()
Determine if a dynamic route declaration token is a literal segment, i.e. neither a param token nor an option
protected
isDynamicRouteLiteral(string $token) : bool
Parameters
- $token : string
Return values
boolmatchesDynamicRoute()
Determine if the current request matches the dynamic route declaration: every literal segment of the declaration has to line up with the request's segment in that same position, and the request has to carry a segment where the declaration puts its controller token
protected
matchesDynamicRoute() : bool
Return values
boolnormalizeController()
Normalize a raw dispatchable value (closure, native callable, or a pop-utils pseudo-callable string such as 'Class->method', 'Class::method', 'Class', or 'new Class') into a ['controller' => $controller] config array. Already-formed config arrays (and nested-route sub-arrays) are returned unchanged.
protected
normalizeController(mixed $controller) : mixed
Parameters
- $controller : mixed
parseDynamicRoute()
Parse a dynamic route declaration, recording where its ':controller'/':action' (HTTP) or '<controller>'/'<action>' (CLI) tokens sit within the declaration, along with any literal segments the request has to match for the route to apply
protected
parseDynamicRoute(string $route) : void
Parameters
- $route : string
registerDynamicRoute()
Register a dynamic route
protected
registerDynamicRoute(string $route, mixed $controller) : void
Parameters
- $route : string
- $controller : mixed
registerRegularRoute()
Register a regular (literal or param-bearing) route, recursing for nested route configs
protected
registerRegularRoute(string $route, mixed $controller) : mixed
Parameters
- $route : string
- $controller : mixed
Return values
mixed —the normalized controller config
registerWildcardRoute()
Register a wildcard/default route
protected
registerWildcardRoute(string $route, mixed $controller) : mixed
Parameters
- $route : string
- $controller : mixed
Return values
mixed —the normalized controller config