psr7-middlewares

Collection of PSR-7 middlewares.

Requirements

PHP >= 5.5
A PSR-7 HTTP Message implementation, for example zend-diactoros
A PSR-7 middleware dispatcher compatible with the following signature:

use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

function (RequestInterface $request, ResponseInterface $response, callable $next) {
    // ...
}

So, you can use these midlewares with:

Instalation

This package is installable and autoloadable via Composer as oscarotero/psr7-middlewares.

$ composer require oscarotero/psr7-middlewares

Usage example:

use Psr7Middlewares\Middleware;

use Relay\RelayBuilder;
use Zend\Diactoros\Response;
use Zend\Diactoros\ServerRequestFactory;
use Zend\Diactoros\Stream;

//Set a stream factory used by some middlewares
//(Required only if Zend\Diactoros\Stream is not detected)
Middleware::setStreamFactory(function ($file, $mode) {
    return new Stream($file, $mode);
});

//Create a relay dispatcher and add some middlewares:
$relay = new RelayBuilder();

$dispatcher = $relay->newInstance([

    //Calculate the response time
    Middleware::responseTime(),

    //Add an Uuid to request
    Middleware::uuid(),
    
    //Handle errors
    Middleware::errorHandler('error_handler_function')->catchExceptions(true),

    //Override the method using X-Http-Method-Override header
    Middleware::methodOverride(),

    //Removes www subdomain
    Middleware::www(false)->redirect(301),

    //Block search engines robots indexing
    Middleware::robots(),

    //Geolocation
    Middleware::geolocate(),

    //Detect client device
    Middleware::detectDevice(),

    //Parse the request payload
    Middleware::payload(),

    //Remove the path prefix
    Middleware::basePath('/my-site/web'),

    //Remove the trailing slash
    Middleware::trailingSlash(),

    //Digest authentication
    Middleware::digestAuthentication(['username' => 'password']),

    //Get the client ip
    Middleware::clientIp(),

    //Allow only some ips
    Middleware::firewall(['127.0.0.*']),

    //Detects the user preferred language
    Middleware::languageNegotiator(['gl', 'es', 'en']),

    //Detects the format
    Middleware::formatNegotiator(),

    //Execute fast route
    Middleware::fastRoute($app->get('dispatcher')),

    //Adds the php debug bar
    Middleware::debugBar(),

    //Add Google Analytics
    Middleware::googleAnalytics('UA-XXXXX-X'),

    //Minify the result
    Middleware::minify(),
]);

$response = $dispatcher(ServerRequestFactory::fromGlobals(), new Response());

Available middlewares

AccessLog
AuraRouter
AuraSession
BasePath
BasicAuthentication
Cache
ClientIp
Cors
DebugBar
DetectDevice
DigestAuthentication
EncodingNegotiator
ErrorHandler
FastRoute
FormTimestamp
Firewall
FormatNegotiator
Geolocate
GoogleAnalytics
Honeypot
ImageTransformer
LanguageNegotiation
LeagueRoute
MethodOverride
Minify
Payload
PhpSession
Piwik
ReadResponse
Rename
ResponseTime
Robots
SaveResponse
Shutdown
TrailingSlash
Uuid
Whoops
Www

AccessLog

To generate access logs for each request using the Apache's access log format. This middleware requires a Psr log implementation, for example monolog:

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\AuraRouter;
use Monolog\Logger;
use Monolog\Handler\ErrorLogHandler;

//Create the logger
$logger = new Logger('access');
$logger->pushHandler(new ErrorLogHandler());

//Add to the dispatcher
$dispatcher = $relay->getInstance([

    //Required to get the Ip
    Middleware::ClientIp(),

    Middleware::AccessLog()
        ->logger($logger) //Instance of Psr\Log\LoggerInterface
        ->combined(true)  //(optional) To use the Combined Log Format instead the Common Log Format
]);

AuraRouter

To use Aura.Router (3.x) as a middleware:

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\AuraRouter;
use Aura\Router\RouterContainer;

//Create the router
$routerContainer = new RouterContainer();

$map = $routerContainer->getMap();

$map->get('hello', '/hello/{name}', function ($request, $response, $myApp) {

    //The route parameters are stored as attributes
    $name = $request->getAttribute('name');

    //You can get also the route instance
    $route = AuraRouter::getRoute($request);

    //Write directly in the response's body
    $response->getBody()->write('Hello '.$name);

    //or echo the output (it will be captured and writted into body)
    echo 'Hello world';

    //or return a string
    return 'Hello world';

    //or return a new response
    return $response->withStatus(200);
});

//Add to the dispatcher
$dispatcher = $relay->getInstance([

    Middleware::AuraRouter()
        ->router($routerContainer)   //Instance of Aura\Router\RouterContainer
        ->arguments($myApp)          //(optional) append more arguments to the controller
]);

AuraSession

Creates a new Aura.Session instance with the request.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\AuraSession;

$dispatcher = $relay->getInstance([

    Middleware::AuraSession(),
        ->factory($sessionFactory) //(optional) Intance of Aura\Session\SessionFactory
        ->name('my-session-name'), //(optional) custom session name

    function ($request, $response, $next) {
        //Get the session instance
        $session = AuraSession::getSession($request);

        return $response;
    }
]);

BasePath

Strip off the prefix from the uri path of the request. This is useful to combine with routers if the root of the website is in a subdirectory. For example, if the root of your website is /web/public, a request with the uri /web/public/post/34 will be converted to /post/34. You can provide the basePath to remove or let the middleware autodetect it.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\BasePath;

$dispatcher = $relay->getInstance([
    Middleware::BasePath()
        ->basePath('/web/public') // (optional) The path to remove...
        ->autodetect(true),       // (optional) ...or autodetect the base path

    function ($request, $response, $next) {
        //Get the stripped off prefix
        $basePath = BasePath::getBasePath($request);

        return $response;
    }
]);

BasicAuthentication

Implements the basic http authentication. You have to provide an array with all users and password:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::BasicAuthentication()
        ->users([
            'username1' => 'password1',
            'username2' => 'password2'
        ])
        ->realm('My realm') //(optional) change the realm value
]);

Cache

To save and reuse responses based in the Cache-Control: max-age directive and Expires header. You need a cache library compatible with psr-6

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::Cache()
        ->cache(new Psr6CachePool()) //the psr-6 cache implementation

    function($request, $response, $next) {
        //Cache the response 1 hour
        return $response->withHeader('Cache-Control', 'max-age=3600');
    }
]);

ClientIp

Detects the client ip(s).

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\ClientIp;

$dispatcher = $relay->getInstance([

    Middleware::ClientIp()
        ->remote()  // (optional) Hack to get the ip from localhost environment
        ->headers([ // (optional) to change the trusted headers
            'Client-Ip',
            'X-Forwarded-For',
            'X-Forwarded'
        ]),

    function ($request, $response, $next) {
        //Get the user ip
        $ip = ClientIp::getIp($request);

        //Get all ips found in the headers
        $all_ips = ClientIp::getIps($request);

        return $next($request, $response);
    }
]);

Cors

To use the neomerx/cors-psr7 library:

use Neomerx\Cors\Strategies\Settings

$relay = new RelayBuilder();

$settings = (new Settings())
    ->setServerOrigin([
        'scheme' => 'http',
        'host'   => 'example.com',
        'port'   => '123',
    ]);

$dispatcher = $relay->getInstance([

    Middleware::Cors()
        ->settings($settings)
]);

DebugBar

Inserts the PHP debug bar in the html body. This middleware requires Middleware::formatNegotiator executed before, to insert the debug bar only in Html responses.

use Psr7Middlewares\Middleware;
use DebugBar\StandardDebugBar;

$dispatcher = $relay->getInstance([

    Middleware::FormatNegotiator(),

    Middleware::DebugBar()
        ->captureAjax(true)                //(optional) To send data in headers in ajax
        ->debugBar(new StandardDebugBar()) //(optional) To pass your own instance.
]);

DetectDevice

Uses Mobile-Detect library to detect the client device.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\DetectDevice;

$dispatcher = $relay->getInstance([

    Middleware::DetectDevice(),

    function ($request, $response, $next) {
        //Get the device info
        $device = DetectDevice::getDevice($request);

        if ($device->isMobile()) {
            //mobile stuff
        }
        elseif ($device->isTablet()) {
            //tablet stuff
        }
        elseif ($device->is('bot')) {
            //bot stuff
        }

        return $next($request, $response);
    },
]);

DigestAuthentication

Implements the digest http authentication. You have to provide an array with the users and password:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::DigestAuthentication()
        ->users([
            'username1' => 'password1',
            'username2' => 'password2'
        ])
        ->realm('My realm') //(optional) custom realm value
        ->nonce(uniqid())   //(optional) custom nonce value
]);

EncodingNegotiator

Uses willdurand/Negotiation (2.x) to detect and negotiate the encoding type of the document.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\EncodingNegotiator;

$dispatcher = $relay->getInstance([

    Middleware::EncodingNegotiator()
        ->encodings(['gzip', 'deflate']), //(optional) configure the supported encoding types

    function ($request, $response, $next) {
        //get the encoding (for example: gzip)
        $encoding = EncodingNegotiator::getEncoding($request);

        return $next($request, $response);
    }
]);

ErrorHandler

Executes a handler if the response returned by the next middlewares has any error (status code 400-599). You can catch also the exceptions throwed.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\ErrorHandler;

function errorHandler($request, $response, $myApp) {
    switch ($response->getStatusCode()) {
        case 404:
            return 'Page not found';

        case 500:
            //you can get the exception catched
            $exception = ErrorHandler::getException($request);

            return 'Server error: '.$exception->getMessage();

        default:
            return 'There was an error'
    }
}

$dispatcher = $relay->getInstance([

    Middleware::ErrorHandler()
        ->handler('errorHandler') //The error handler
        ->arguments($myApp)       //(optional) extra arguments to the handler
        ->catchExceptions()       //(optional) to catch exceptions if you don't use an external library for that
]);

FastRoute

To use FastRoute as a middleware.

use Psr7Middlewares\Middleware;

$router = FastRoute\simpleDispatcher(function (FastRoute\RouteCollector $r) {

    $r->addRoute('GET', '/blog/{id:[0-9]+}', function ($request, $response, $app) {
        return 'This is the post number'.$request->getAttribute('id');
    });
});

$dispatcher = $relay->getInstance([

    Middleware::FastRoute()
        ->router($router)  //Instance of FastRoute\Dispatcher
        ->argument($myApp) //(optional) arguments appended to the controller
]);

Firewall

Uses M6Web/Firewall to provide a IP filtering. This middleware deppends of ClientIp (to extract the ips from the headers).

See the ip formats allowed for trusted/untrusted options:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    //required to capture the user ips before
    Middleware::ClientIp(),

    //set the firewall
    Middleware::Firewall()
        ->trusted(['123.0.0.*'])   //(optional) ips allowed
        ->untrusted(['123.0.0.1']) //(optional) ips not allowed
]);

FormatNegotiator

Uses willdurand/Negotiation (2.x) to detect and negotiate the format of the document using the url extension and/or the Accept http header. It also adds the Content-Type header to the response if it's missing.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\FormatNegotiator;

$dispatcher = $relay->getInstance([

    Middleware::FormatNegotiator()
        ->defaultFormat('html') //(optional) default format if it's unable to detect. (by default is "html")
        ->addFormat('pdf', ['application/pdf', 'application/x-download']), //(optional) add new formats and mimetypes

    function ($request, $response, $next) {
        //get the format (for example: html)
        $format = FormatNegotiator::getFormat($request);

        return $next($request, $response);
    }
]);

FormTimestamp

Simple spam protection based on injecting a hidden input in all post forms with the current timestamp. On submit the form, check the time value. If it's less than (for example) 3 seconds ago, assumes it's a bot, so returns a 403 response. You can also set a max number of seconds before the form expires.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    //required to get the format of the request (only executed in html requests)
    Middleware::FormatNegotiator(),

    Middleware::FormTimestamp()
        ->min(5)                  //(optional) Minimum seconds needed to validate the request (default: 3)
        ->max(3600)               //(optional) Life of the form in second. Default is 0 (no limit)
        ->inputName('time-token') //(optional) Name of the input (default: hpt_time)
        ->key('my-secret-key'),   //(optional but recomended) Key used to encrypt/decrypt the input value. If it's not defined, the value wont be encrypted
]);

Geolocate

Uses Geocoder library to geolocate the client using the ip. This middleware deppends of ClientIp (to extract the ips from the headers).

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\Geolocate;

$dispatcher = $relay->getInstance([
    
    //required to capture the user ips before
    Middleware::ClientIp(),

    Middleware::Geolocate()
        ->geocoder($geocoder), //(optional) To provide a custom Geocoder instance

    function ($request, $response, $next) {
        //get the location
        $addresses = Geolocate::getLocation($request);

        //get the country
        $country = $addresses->first()->getCountry();

        $response->getBody()->write('Hello to '.$country);

        return $next($request, $response);
    }
]);

GoogleAnalytics

Inject the Google Analytics code in all html pages.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    //required to get the format of the request
    Middleware::formatNegotiator(),
    
    Middleware::GoogleAnalytics()
        ->siteId('UA-XXXXX-X') // The site id
]);

Gzip

Use gzip functions to compress the response body, inserting also the Content-Encoding header.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    //required to get the preferred encoding type
    Middleware::EncodingNegotiator(),

    Middleware::Gzip()
]);

Honeypot

Implements a honeypot spam prevention. This technique is based on creating a input field that should be invisible and left empty by real users but filled by most spam bots. The middleware scans the html code and inserts this inputs in all post forms and check in the incoming requests whether this value exists and is empty (is a real user) or doesn't exist or has a value (is a bot) returning a 403 response.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    //required to get the format of the request (only executed in html requests)
    Middleware::formatNegotiator(),
    
    Middleware::Honeypot()
        ->inputName('my_name') //(optional) The name of the input field (by default "hpt_name")
        ->inputClass('hidden') //(optional) The class of the input field (by default "hpt_input")
]);

ImageTransformer

Uses imagecow/imagecow to transform the images on demand. You can resize, crop, rotate and convert to other format. You can specify a predefined sizes using the imagecow syntax.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    //required to get the format of the request
    Middleware::formatNegotiator(),

    Middleware::imageTransformer()
        ->basePath('/imgs')          // (optional) The base path of the images urls

    //Used to read the image files and returns the response with them
    Middleware::readResponse()
        ->storage('/path/to/images'),
]);

To resize or crop images on demand, use the following syntax: [directory]/[transform].[filename]. For example, to resize and crop the image avatars/users.png to 50x50px, the path is: avatars/resizeCrop,50,50.user.png. Because this method allows to generate unlimited images using random values, you can specify a list of named transform values:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    Middleware::formatNegotiator(),

    Middleware::imageTransformer()
        ->sizes([
            'small' => 'resizeCrop,50,50',
            'medium' => 'resize,500|format,jpg',
            'large' => 'resize,1000|format,jpg',
        ]), //(optional) The predefined sizes of the images.

    Middleware::readResponse('/path/to/images')
]);

Now, to get the 50x50 thumb, you have to use avatars/small.user.png. Any other value different to these predefined sizes returns a 404 response.

LanguageNegotiation

Uses willdurand/Negotiation to detect and negotiate the client language. You must provide an array with all available languages:

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\LanguageNegotiator;

$dispatcher = $relay->getInstance([

    Middleware::LanguageNegotiator()
        ->languages(['gl', 'en', 'es']), //Available languages

    function ($request, $response, $next) {
        //Get the preferred language
        $language = LanguageNegotiator::getLanguage($request);

        return $next($request, $response);
    }
]);

LeagueRoute

To use league/route (2.x) as a middleware:

use Psr7Middlewares\Middleware;
use League\Route\RouteCollection;

$router = new RouteCollection();

$router->get('/blog/{id:[0-9]+}', function ($request, $response, $vars) {
    return 'This is the post number'.$vars['id'];
});

$dispatcher = $relay->getInstance([

    Middleware::LeagueRoute()
        ->router($router) //The RouteCollection instance
]);

MethodOverride

Overrides the request method using the X-Http-Method-Override header. This is useful for clients unable to send other methods than GET and POST:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::MethodOverride()
        ->get(['HEAD', 'CONNECT', 'TRACE', 'OPTIONS']), //(optional) to customize the allowed GET overrided methods
        ->post(['PATCH', 'PUT', 'DELETE', 'COPY', 'LOCK', 'UNLOCK']), //(optional) to customize the allowed POST overrided methods
]);

Minify

Uses mrclay/minify to minify the html, css and js code from the responses.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    //required to get the format of the response
    Middleware::formatNegotiator(),

    Middleware::Minify()
        ->forCache(true) //(optional) only minify cacheable responses
]);

Payload

Parses the body of the request if it's not parsed and the method is POST, PUT or DELETE. It has support for json, csv and url encoded format.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    Middleware::Payload(),

    function ($request, $response, $next) {
        //Get the parsed body
        $content = $request->getParsedBody();

        return $next($request, $response);
    }
]);

PhpSession

Initializes a php session using the request data.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    Middleware::PhpSession()
        ->name('SessionId') //(optional) Name of the session
        ->id('ABC123')      //(optional) Id of the session

    function ($request, $response, $next) {
        //Use the global $_SESSION variable to get/set data
        $_SESSION['name'] = 'John';

        return $next($request, $response);
    }
]);

Piwik

To use the Piwik analytics platform. Injects the javascript code just before the </body> closing tag.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([
    
    //required to get the format of the request
    Middleware::formatNegotiator(),
    
    Middleware::Piwik()
        ->piwikUrl('//example.com/piwik')    // The url of the installed piwik
        ->siteId(1)                          // (optional) The site id (1 by default)
        ->addOption('setDoNotTrack', 'true') // (optional) Add more options to piwik API
]);

ReadResponse

Read the response content from a file. It's the opposite of SaveResponse

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::ReadResponse()
        ->storage('path/to/document/root') //Path where the files are stored
        ->basePath('public')               //(optional) basepath ignored from the request uri
]);

Rename

Renames the request path. This is useful in some use cases:

To rename public paths with random suffixes for security reasons, for example the path /admin to a more unpredictible /admin-19640983
Create pretty urls without use any router. For example to access to the path /static-pages/about-me.php under the more friendly /about-me

Note that the original path wont be publicly accesible. On above examples, requests to /admin or /static-pages/about-me.php returns 404 responses.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::Rename()
        ->paths([
            '/admin' => '/admin-19640983',
        ]),

    function ($request, $response, $next) {
        $path = $request->getUri()->getPath(); // /admin

        return $next($request, $response);
    }
]);

ResponseTime

Calculates the response time (in miliseconds) and saves it into X-Response-Time header:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::ResponseTime()
]);

Robots

Disables the robots of the search engines for non-production environment. Adds automatically the header X-Robots-Tag: noindex, nofollow, noarchive in all responses and returns a default body for /robots.txt request.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::Robots()
]);

SaveResponse

Saves the response content into a file if all of the following conditions are met:

The method is GET
The status code is 200
The Cache-Control header does not contain no-cache value
The request has not query parameters.

This is useful for cache purposes

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::SaveResponse()
        ->storage('path/to/document/root') //Path directory where save the responses
        ->basePath('public')               //(optional) basepath ignored from the request uri
]);

Shutdown

Useful to display a 503 maintenance page. You need to specify a handler.

use Psr7Middlewares\Middleware;

function shutdownHandler ($request, $response, $app) {
    $response->getBody()->write('Service unavailable');
}

$dispatcher = $relay->getInstance([

    Middleware::Shutdown()
        ->handler('shutdownHandler') //Callable that generate the response
        ->arguments($app)            //(optional) to add extra arguments to the handler
]);

TrailingSlash

Removes (or adds) the trailing slash of the path. For example, /post/23/ will be converted to /post/23. If the path is / it won't be converted. Useful if you have problems with the router.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::TrailingSlash()
        ->addSlash(true)     //(optional) to add the trailing slash instead remove
        ->redirect(301)      //(optional) to return a 301 (seo friendly) or 302 response to the new path
        ->basePath('public') //(optional) basepath
]);

Uuid

Uses ramsey/uuid to generate an Uuid (Universally Unique Identifiers) for each request (compatible with RFC 4122 versions 1, 3, 4 and 5). It's usefull for debugging purposes.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\Uuid;

$dispatcher = $relay->getInstance([

    Middleware::Uuid()
        ->version(4)     //(optional) version of the identifier (1 by default). Versions 3 and 5 need more arguments (see https://github.com/ramsey/uuid#examples)
        ->header(false), //(optional) Name of the header to store the identifier (X-Uuid by default). Set false to don't save header

    function ($request, $response, $next) {
        //Get the X-Uuid header
        $id = $request->getHeaderLine('X-Uuid');

        //Get the Uuid instance
        $uuid = Uuid::getUuid($request);

        echo $uuid->toString();

        return $next($request, $response);
    }
]);

Whoops

To use whoops as error handler.

use Psr7Middlewares\Middleware;
use Psr7Middlewares\Middleware\Whoops;
use Whoops\Run;

$dispatcher = $relay->getInstance([

    Middleware::Whoops()
        ->whoops(new Run())  //(optional) provide a whoops instance
        ->catchErrors(false) //(optional) to catch not only exceptions but also php errors (true by default)
]);

Www

Adds or removes the www subdomain in the host uri and, optionally, returns a redirect response. The following types of host values wont be changed:

The one word hosts, for example: http://localhost.
The ip based hosts, for example: http://0.0.0.0.
The multi domain hosts, for example: http://subdomain.example.com.

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    Middleware::Www()
        ->addWww(true)  //(optional) Add www instead remove it
        ->redirect(301) //(optional) to return a 301 (seo friendly) or 302 response to the new host
]);

Lazy/conditional middleware creation

You may want to create middleware in a lazy way under some circunstances:

The middleware is needed only in a specific context (for example in development environments)
The middleware creation is expensive and is not needed always (because a previous middleware returns a cached response)

To handle with this, you can use the Middleware::create() method that must return a callable or false. Example:

use Psr7Middlewares\Middleware;

$dispatcher = $relay->getInstance([

    //This middleware can return a cached response
    //so the next middleware may not be executed
    Middleware::cache($myPsr6CachePool),

    //Let's say this middleware is expensive, so use a proxy for lazy creation
    Middleware::create(function () use ($app) {
        return Middleware::auraRouter($app->get('router'));
    }),

    //This middleware is needed only in production
    Middleware::create(function () {
        return (getenv('ENV') !== 'production') ? false : Middleware::minify();
    })
]);

Extending middlewares

Some middlewares use different functions to change the http messages, depending of some circunstances. For example, Payload parses the raw body content, and the method used depends of the type of the content: it can be json, urlencoded, csv, etc. Other example is the Minify middleware that needs a different minifier for each format (html, css, js, etc), or the Gzip that depending of the Accept-Encoding header, use a different method to compress the response body.

The interface Psr7Middlewares\Transformers\ResolverInterface provides a way to resolve and returns the apropiate "transformer" in each case. The transformer is just a callable that accepts a http message (request or response) and returns the transformed message again. You can create custom resolvers or extend the included in this package to add your owns. Let's see an example:

use Psr7Middlewares\Transformers\BodyParser;
use Psr\Http\Message\ServerRequestInterface;

class MyBodyParser extends BodyParser
{
    /**
     * New parser used in request with the format "php"
     */
    public function php(ServerRequestInterface $request)
    {
        $data = unserialize((string) $request->getBody());

        return $request->withParsedBody($data);
    }
}

//Use the resolver
$dispatcher = $relay->getInstance([
    Middleware::Payload()->resolver(new MyBodyParser())
]);

The following middlewares are using resolvers that you can customize:

Payload To parse the body according with the format (json, urlencoded, csv, ...)
Gzip To encode the body with the encoding method supported by the browser (gzip, deflate)
Minify To use different minifiers for each format (html, css, js, ...)

Contribution

New middlewares are appreciated. Just create a pull request.

Name		Name	Last commit message	Last commit date
Latest commit History 291 Commits
src		src
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
.travis.yml		.travis.yml
LICENSE		LICENSE
README.md		README.md
composer.json		composer.json
phpunit.xml		phpunit.xml

License

snapshotpl/psr7-middlewares

Folders and files

Latest commit

History

Repository files navigation