Component to route PSR-7 requests through PSR-15 middlewares
MIT License
The Psr15 Router component allows you to route PSR-7 requests through PSR-15 middlewares.
To install the latest stable version of this component, open a console and execute the following command:
$ composer require ajgarlag/psr15-router
You can choose if you want to route your request through a MiddlewareInterface or a RequestHandlerInterface
With this option, you has to build a Router
to discriminate which middleware will process the request.
Then build RouterMiddleware
to process the request:
use Ajgarlag\Psr15\Router\Matcher\UriRegexRequestMatcher;
use Ajgarlag\Psr15\Router\Middleware\Route;
use Ajgarlag\Psr15\Router\Middleware\ArrayRouter;
use Ajgarlag\Psr15\Router\Middleware\RouterMiddleware;
$userMiddleware; //Some middleware to process user requests
$userRoute = new Route(
new UriRegexRequestMatcher('^http(s)?://example.org/user/'),
$userMiddleware
);
$adminMiddleware; //Some middleware to process admin requests
$adminRoute = new Route(
new UriRegexRequestMatcher('^http(s)?://example.org/admin/'),
$adminMiddleware
);
$router = new ArrayRouter();
$router->addRoute($userRoute);
$router->addRoute($adminRoute);
$routerMiddleware = new RouterMiddleware($router);
$response = $routerMiddleware->process($request, $requestHandler);
If the router does not return any middleware to process the request, it is processed directly through the request handler.
With this option, you has to build a Router
to discriminate which request handler will process the request.
Then build RouterRequestHandler
to process the request. A failover request handler is required to process the request
if the router cannot route the request. Usually this failover request handler should return a 404 response.
use Ajgarlag\Psr15\Router\Matcher\UriRegexRequestMatcher;
use Ajgarlag\Psr15\Router\RequestHandler\Route;
use Ajgarlag\Psr15\Router\RequestHandler\ArrayRouter;
use Ajgarlag\Psr15\Router\RequestHandler\RouterRequestHandler;
$userRequestHandler; //Some request handler to process user requests
$userRoute = new Route(
new UriRegexRequestMatcher('^http(s)?://example.org/user/'),
$userRequestHandler
);
$adminRequestHandler; //Some request handler to process admin requests
$adminRoute = new Route(
new UriRegexRequestMatcher('^http(s)?://example.org/admin/'),
$adminRequestHandler
);
$router = new ArrayRouter();
$router->addRoute($userRoute);
$router->addRoute($adminRoute);
$failoverRequestHandler; // Request handler that returns 404 unconditionally
$routerRequestHandler = new RouterRequestHandler($router, $failoverRequestHandler);
$response = $routerRequestHandler->handle($request);
This component is under the MIT license. See the complete license in the LICENSE file.
Issues and feature requests are tracked in the Github issue tracker.
Developed with ♥ by Antonio J. García Lagar.
If you find this component useful, please add a ★ in the GitHub repository page and/or the Packagist package page.