ajgarlag/psr15-router

Component to route PSR-7 requests through PSR-15 middlewares

Psr15 Router

The Psr15 Router component allows you to route PSR-7 requests through PSR-15 middlewares., _(*1)

, _(*2)

Installation

To install the latest stable version of this component, open a console and execute the following command:, _(*3)

$ composer require ajgarlag/psr15-router

Usage

You can choose if you want to route your request through a MiddlewareInterface or a RequestHandlerInterface, _(*4)

Middleware routing

With this option, you has to build a Router to discriminate which middleware will process the request. Then build RouterMiddleware to process the request:, _(*5)

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., _(*6)

Request handler routing

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., _(*7)

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);

License

This component is under the MIT license. See the complete license in the LICENSE file., _(*8)

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker., _(*9)

Author Information

Developed with ♥ by Antonio J. García Lagar., _(*10)

If you find this component useful, please add a ★ in the GitHub repository page and/or the Packagist package page., _(*11)