An HTTP Interop compatible middleware dispatcher in Minormous. Attempts to be PSR-1, PSR-2, PSR-4, PSR-7, and PSR-15 compliant.
Heavily influenced by the design of Tari by ircmaxwell.
For more information, see the documentation.
composer require minormous/dispatch
The MiddlewareCollection is a container for middleware that acts as the entry point.
It takes two arguments:
- An array of
$middlewarewhich must be instances of server middleware. - A callable
$defaultthat acts as the terminator for the collection and returns an empty response.
Once the collection is prepared it can dispatched with a server request and will return the response for output.
use Minormous\Dispatch\MiddlewareCollection;
// Any implementation of PSR-15 MiddlewareInterface
$middleware = [
new FooMiddleware(),
// ...
];
// Default handler for end of collection
$default = function (ServerRequestInterface $request) {
// Any implementation of PSR-7 ResponseInterface
return new Response();
};
$collection = new MiddlewareCollection($middleware);
// Any implementation of PSR-7 ServerRequestInterface
$request = ServerRequest::fromGlobals();
$response = $collection->dispatch($request, $default);The MiddlewareCollection also implements the MiddlewareInterface to allow
collections to be nested:
use Minormous\Dispatch\MiddlewareCollection;
// Any implementation of PSR-15 MiddlewareInterface
$middleware = [
new FooMiddleware(),
// A nested collection
new MiddlewareCollection(...),
// More middleware
new BarMiddleware(),
// ...
];
$collection = new MiddlewareCollection($middleware);
// HTTP factories can also be used
$default = [$responseFactory, 'createResponse'];
$request = $serverRequestFactory->createRequest($_SERVER);
$response = $collection->dispatch($request, $default);