slince/middleware

A flexible PSR15 middleware dispatcher

2.0.1 2019-04-30 11:38 UTC

Requires

• php: >=7.0
• http-interop/http-server-middleware: ^1.0
• psr/http-message: ^1.0

Requires (Dev)

• phpunit/phpunit: ^5.0|^6.0
• zendframework/zend-diactoros: ^1.0

MIT

• Tao

• http
• middleware
• psr-7
• middlewares
• psr-15
• middleware-dispatcher

README

The package is a flexible PSR-15 middleware dispatcher for PSR-7 request message that help to create middlewares and dispatch.

Installation

Install via composer

composer require slince/middleware

Quick example

$dispatcher = new Slince\Middleware\Dispatcher([$middleware1, $middleware2]);

$response = $dispatcher->process(Zend\Diactoros\ServerRequestFactory::fromGlobals());

var_dump($response instanceof Psr\Http\Message\ResponseInterface);

Usage

Add middleware

Add PSR-15 middlewares to the queue

use Psr\Http\Message\ServerRequestInterface;
use Interop\Http\Server\MiddlewareInterface;
use Interop\Http\Server\RequestHandlerInterface;
use Zend\Diactoros\Response;

class MyMiddleware implements MiddlewareInteface
{
    public function process(ServerRequestInterface $request, RequestHandlerInterface $next) 
    {
        $response = new Response();
        $response->getBody()->write('hello world');
        return $response;
    }
}
$dispatcher = new Slince\Middleware\Dispatcher([
    new MyMiddleware()
]);

Or add a callable function directly

$dispatcher->push(function(ServerRequestInterface $request, RequestHandlerInterface $next){
    return $delegate->process($request);
});

Dispatch

try {
    $response = $dispatcher->process(Zend\Diactoros\ServerRequestFactory::fromGlobals());
} catch (Slince\Middleware\Exception\MissingResponseException $exception) {
    //...
}

A MissingResponseException will be thrown if the middleware did not return a invalid response or the queue was exhausted

License

The MIT license. See MIT