Class RoutingMiddleware
Applies routing rules to the request and creates the controller instance if possible.
Constants
-
stringROUTE_COLLECTION_CACHE_KEY ¶'routeCollection'Key used to store the route collection in the cache engine
Property Summary
-
$app protected
Cake\Routing\RoutingApplicationInterfaceThe application that will have its routing hook invoked.
-
$cacheConfig protected
string|nullThe cache configuration name to use for route collection caching, null to disable caching
Method Summary
-
__construct() public
Constructor
-
buildRouteCollection() protected
Check if route cache is enabled and use the configured Cache to 'remember' the route collection
-
loadRoutes() protected
Trigger the application's routes() hook if the application exists and Router isn't initialized. Uses the routes cache if enabled via configuration param "Router.cache"
-
prepareRouteCollection() protected
Generate the route collection using the builder
-
process() public
Apply routing and update the request.
Method Detail
__construct() ¶ public
__construct(Cake\Routing\RoutingApplicationInterface $app, string|null $cacheConfig = null)Constructor
Parameters
-
Cake\Routing\RoutingApplicationInterface$app The application instance that routes are defined on.
-
string|null$cacheConfig optional The cache config name to use or null to disable routes cache
buildRouteCollection() ¶ protected
buildRouteCollection(): Cake\Routing\RouteCollectionCheck if route cache is enabled and use the configured Cache to 'remember' the route collection
Returns
Cake\Routing\RouteCollectionloadRoutes() ¶ protected
loadRoutes(): voidTrigger the application's routes() hook if the application exists and Router isn't initialized. Uses the routes cache if enabled via configuration param "Router.cache"
If the middleware is created without an Application, routes will be loaded via the automatic route loading that pre-dates the routes() hook.
Returns
voidprepareRouteCollection() ¶ protected
prepareRouteCollection(): Cake\Routing\RouteCollectionGenerate the route collection using the builder
Returns
Cake\Routing\RouteCollectionprocess() ¶ public
process(ServerRequestInterface $request, RequestHandlerInterface $handler): Psr\Http\Message\ResponseInterfaceApply routing and update the request.
Any route/path specific middleware will be wrapped around $next and then the new middleware stack will be invoked.
Parameters
-
ServerRequestInterface$request The request.
-
RequestHandlerInterface$handler The request handler.
Returns
Psr\Http\Message\ResponseInterface