README

Slim and simple PSR-15 compliant middleware runner library for PHP.

Installation

Install via the composer utility.

composer require "phoole/middleware"

or add the following lines to your composer.json

{
    "require": {
       "phoole/middleware": "1.*"
    }
}

Features

Able to use PSR-15 compliant middlewares out there.
Able to use a middleware queue (a group of middlewares) as a generic middleware in another(or the main) queue.

Usage

Create the middleware queue, then process all the middlewares.

use Phoole\Middleware\Queue;
use GuzzleHttp\Psr7\Response;
use GuzzleHttp\Psr7\ServerRequest;

// create middleware queue with 404 response as default(last)
$mws = new Queue(new Response(404));

// add middlewares
$mws->add(
    new LoggerMiddleware(),
    new DispatcherMiddleware()
);

// process the request with middlewares
$response = $mws->handle(new ServerRequest('GET', 'http://bingo.com/get'));

Advanced

Subqueue

Phoole\Middleware\Queue implements the Psr\Http\Server\MiddlewareInterface, so the queue itself can be used as a generic middleware.

// subqueue may need no default response if not the last in the main queue
$subQueue = (new Queue())->add(
    new ResponseTimeMiddleware(),
    new LoggingMiddleware()
);

// main middleware queue
$mws = (new Queue(new Response(404)))->add(
    $subQueue,
    new DispatcherMiddleware()
);

Testing

$ composer test

Dependencies

PHP >= 7.2.0
phoole/base 1.*
A PSR-7 HTTP message implementation, such as guzzle/psr7.

License

Apache 2.0

phoole / middleware

Maintainers

Details