Thingston HTTP Router

An HTTP router supporting PSR-15 request handlers.

Usage

use Thingston\Http\Router\RequestHandlerResolver;
use Thingston\Http\Router\Route;
use Thingston\Http\Router\Router;

$router = new Router();

$router->addRoute(new Route(['GET'], '/', 'home', 'HomeHandler'))
    ->addRoute(new Route(['GET'], '/about', 'about', 'AboutHandler'))
    ->addRoute(new Route(['GET'], '/hello/{name}', 'hello', 'HelloHandler'));

/** @var Psr\Http\Message\ServerRequestInterface $request */
$matchedRoute = $router->match($request);

$resolver = new RequestHandlerResolver();

/** @var Psr\Http\Server\RequestHandlerInterface $requestHandler */
$requestHandler = $resolver->resolve($matchedRoute);

/** @var Psr\Http\Message\ResponseInterface $response */
$response = $requestHandler->handle($request);

Resolving Route Handlers

Like in the example above the RequestHandlerResolver always resolves a Route handler as an instance of Psr\Http\Server\RequestHandlerInterface which can be invoked to handle a Server Request instance.

However a Route Handler can be defined in some different ways:

• An instance of Psr\Http\Server\RequestHandlerInterface already;
• Any PHP callable;
• A string representing the FQNS of an invokable class;
• A string representing the FQNS of any class and its method name separated by @ (e.g App\Action\MyAction@index);
• Any string representing a Container key which returns an invokable class instance.