Class RouteCollection
Contains a collection of routes.
Provides an interface for adding/removing routes and parsing/generating URLs with the routes it contains.
Property Summary
-
$_extensions protected
string[]Route extensions
-
$_middleware protected
arrayA map of middleware names and the related objects.
-
$_middlewareGroups protected
arrayA map of middleware group names and the related middleware names.
-
$_middlewarePaths protected
arrayA map of paths and the list of applicable middleware.
-
$_named protected
Cake\Routing\Route\Route[]The hash map of named routes that are in this collection.
-
$_paths protected
arrayRoutes indexed by path prefix.
-
$_routeTable protected
arrayThe routes connected to this collection.
-
$_routes protected
Cake\Routing\Route\Route[]The routes connected to this collection.
Method Summary
-
_getNames() protected
Get the set of names from the $url. Accepts both older style array urls, and newer style urls containing '_name'
-
add() public
Add a route to the collection.
-
applyMiddleware() public
Apply a registered middleware(s) for the provided path
-
extensions() public deprecated
Get/set the extensions that the route collection could handle.
-
getExtensions() public
Get the extensions that can be handled.
-
getMiddleware() public
Get an array of middleware given a list of names
-
hasMiddleware() public
Check if the named middleware has been registered.
-
hasMiddlewareGroup() public
Check if the named middleware group has been created.
-
match() public
Reverse route or match a $url array with the connected routes.
-
middlewareExists() public
Check if the named middleware or middleware group has been registered.
-
middlewareGroup() public
Add middleware to a middleware group
-
named() public
Get the connected named routes.
-
parse() public
Takes the URL string and iterates the routes until one is able to parse the route.
-
parseRequest() public
Takes the ServerRequestInterface, iterates the routes until one is able to parse the route.
-
registerMiddleware() public
Register a middleware with the RouteCollection.
-
routes() public
Get all the connected routes as a flat list.
-
setExtensions() public
Set the extensions that the route collection can handle.
Method Detail
_getNames() ¶ protected
_getNames(array $url): string[]Get the set of names from the $url. Accepts both older style array urls, and newer style urls containing '_name'
Parameters
-
array$url The url to match.
Returns
string[]add() ¶ public
add(Cake\Routing\Route\Route $route, array $options = []): voidAdd a route to the collection.
Parameters
-
Cake\Routing\Route\Route$route The route object to add.
-
array$options optional Additional options for the route. Primarily for the
_nameoption, which enables named routes.
Returns
voidapplyMiddleware() ¶ public
applyMiddleware(string $path, string[] $middleware): $thisApply a registered middleware(s) for the provided path
Parameters
-
string$path The URL path to register middleware for.
-
string[]$middleware The middleware names to add for the path.
Returns
$thisThrows
RuntimeExceptionextensions() ¶ public
extensions(string[]|string|null $extensions = null, bool $merge = true): string[]Get/set the extensions that the route collection could handle.
Parameters
-
string[]|string|null$extensions optional Either the list of extensions to set, or null to get.
-
bool$merge optional Whether to merge with or override existing extensions. Defaults to
true.
Returns
string[]getExtensions() ¶ public
getExtensions(): string[]Get the extensions that can be handled.
Returns
string[]getMiddleware() ¶ public
getMiddleware(string[] $names): arrayGet an array of middleware given a list of names
Parameters
-
string[]$names The names of the middleware or groups to fetch
Returns
arrayThrows
RuntimeExceptionwhen a requested middleware does not exist.
hasMiddleware() ¶ public
hasMiddleware(string $name): boolCheck if the named middleware has been registered.
Parameters
-
string$name The name of the middleware to check.
Returns
boolhasMiddlewareGroup() ¶ public
hasMiddlewareGroup(string $name): boolCheck if the named middleware group has been created.
Parameters
-
string$name The name of the middleware group to check.
Returns
boolmatch() ¶ public
match(array $url, array $context): stringReverse route or match a $url array with the connected routes.
Returns either the URL string generated by the route, or throws an exception on failure.
Parameters
-
array$url The URL to match.
-
array$context The request context to use. Contains _base, _port, _host, _scheme and params keys.
Returns
stringThrows
Cake\Routing\Exception\MissingRouteExceptionWhen no route could be matched.
middlewareExists() ¶ public
middlewareExists(string $name): boolCheck if the named middleware or middleware group has been registered.
Parameters
-
string$name The name of the middleware to check.
Returns
boolmiddlewareGroup() ¶ public
middlewareGroup(string $name, string[] $middlewareNames): $thisAdd middleware to a middleware group
Parameters
-
string$name Name of the middleware group
-
string[]$middlewareNames Names of the middleware
Returns
$thisThrows
RuntimeExceptionnamed() ¶ public
named(): Cake\Routing\Route\Route[]Get the connected named routes.
Returns
Cake\Routing\Route\Route[]parse() ¶ public
parse(string $url, string $method = ''): arrayTakes the URL string and iterates the routes until one is able to parse the route.
Parameters
-
string$url URL to parse.
-
string$method optional The HTTP method to use.
Returns
arrayThrows
Cake\Routing\Exception\MissingRouteExceptionWhen a URL has no matching route.
parseRequest() ¶ public
parseRequest(Psr\Http\Message\ServerRequestInterface $request): arrayTakes the ServerRequestInterface, iterates the routes until one is able to parse the route.
Parameters
-
Psr\Http\Message\ServerRequestInterface$request The request to parse route data from.
Returns
arrayThrows
Cake\Routing\Exception\MissingRouteExceptionWhen a URL has no matching route.
registerMiddleware() ¶ public
registerMiddleware(string $name, callable|string $middleware): $thisRegister a middleware with the RouteCollection.
Once middleware has been registered, it can be applied to the current routing scope or any child scopes that share the same RouteCollection.
Parameters
-
string$name The name of the middleware. Used when applying middleware to a scope.
-
callable|string$middleware The middleware callable or class name to register.
Returns
$thisThrows
RuntimeExceptionroutes() ¶ public
routes(): Cake\Routing\Route\Route[]Get all the connected routes as a flat list.
Returns
Cake\Routing\Route\Route[]setExtensions() ¶ public
setExtensions(string[] $extensions, bool $merge = true): $thisSet the extensions that the route collection can handle.
Parameters
-
string[]$extensions The list of extensions to set.
-
bool$merge optional Whether to merge with or override existing extensions. Defaults to
true.
Returns
$this