https://github.com/slince/middleware

:whale: A PSR15 middleware dispatcher
https://github.com/slince/middleware

dispatcher http http-messages middleware middleware-dispatchers psr-15 psr-7

Last synced: about 2 months ago
JSON representation

:whale: A PSR15 middleware dispatcher

• Host: GitHub
• URL: https://github.com/slince/middleware
• Owner: slince
• License: mit
• Created: 2017-05-26T08:26:19.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2019-04-30T11:40:32.000Z (about 6 years ago)
• Last Synced: 2025-03-30T00:31:20.779Z (3 months ago)
• Topics: dispatcher, http, http-messages, middleware, middleware-dispatchers, psr-15, psr-7
• Language: PHP
• Homepage:
• Size: 16.6 KB
• Stars: 17
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Middleware Dispatcher

[![Build Status](https://img.shields.io/travis/slince/middleware/master.svg?style=flat-square)](https://travis-ci.org/slince/middleware)

[![Coverage Status](https://img.shields.io/codecov/c/github/slince/middleware.svg?style=flat-square)](https://codecov.io/github/slince/middleware)

[![Latest Stable Version](https://img.shields.io/packagist/v/slince/middleware.svg?style=flat-square&label=stable)](https://packagist.org/packages/slince/middleware)

[![Scrutinizer](https://img.shields.io/scrutinizer/g/slince/middleware.svg?style=flat-square)](https://scrutinizer-ci.com/g/slince/middleware/?branch=master)

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

```bash

composer require slince/middleware

```

## Quick example

```php

$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

```php

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

```php

$dispatcher->push(function(ServerRequestInterface $request, RequestHandlerInterface $next){

    return $delegate->process($request);

});

```

### Dispatch

```php

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](https://opensource.org/licenses/MIT)