vmpublishing/psr15-middleware-error-handler

dependency-less middleware to capture and process any throwable with a dedicated error handler

1.0.0 2019-06-18 12:58 UTC

Requires

• php: >=7.2
• fig/http-message-util: *@stable
• psr/http-server-middleware: *@stable

Requires (Dev)

• phpunit/phpunit: *@stable
• vmpublishing/psr15-middleware-test-helpers: *@stable

MIT

• Dirk Gustke

• exception
• error
• slim
• psr-7
• psr-15

README

WHAT

PSR-15 error handling middleware with as low dependencies as possible.

for productive use we like a middleware that captures and processes error into a nicer format (if possible)

this comes with two handler implementations. one just rethrow the error (for development purposes) one responds with the contents of a predefined file and a correct status code (for production use)

INSTALL

To install simply use composer require vmpublishing/psr15-middleware-error-handler:*@stable

USE

This is quite simple: define your handler and add the middleware;

use VM\ErrorHandler\Services\RethrowHandler;

$handler = new RethrowHandler();
$middleware = new ErrorProcessor($handler);

// and for slim, given $app
$app->add($middleware);

// or just add it on the routes you want it on

For the StaticFileHandler you need to pass in at least one file and an empty Response object;

use VM\ErrorHandler\Services\StaticFileHandler;

$handler = new StaticFileHandler('/path/to/500.html', $emptyResponse);
$middleware = new ErrorProcessor($handler);

// and for slim, given $app
$app->add($middleware);
// ...

To have specific ErrorCodes, you need to use the Http Exceptions from this library, ie: NotFound