ellipse / handlers
Psr-15 request handler decorators
Installs: 1 034
Dependents: 5
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: >=7.0
- ellipse/type-errors: ^1.0
- psr/http-message: ^1.0
- psr/http-server-handler: ^1.0
- psr/http-server-middleware: ^1.0
Requires (Dev)
- eloquent/phony-kahlan: ^1.0
- kahlan/kahlan: ^4.0
This package is auto-updated.
Last update: 2024-10-26 00:11:44 UTC
README
This package provides Psr-15 request handler decorators.
Require php >= 7.0
Installation composer require ellipse/handlers
Run tests ./vendor/bin/kahlan
- Fallback request handler
- Request handler with middleware
- Request handler with middleware stack
- Request handler with middleware queue
Fallback request handler
An usual starting point for request handler decorators is to have a request handler returning a default response when its ->handle()
method is called. This package provides an Ellipse\Handlers\FallbackRequestHandler
class implementing this logic.
<?php namespace App; use Ellipse\Handlers\FallbackRequestHandler; // Get some fallback Psr-7 response, here with a 404 status code. $response = some_psr7_response_factory()->withStatus(404); // Create a fallback request handler returning the response. $fallback = new FallbackRequestHandler($response); // The response is returned. $response = $fallback->handle($request);
Request handler with middleware
This package provides an Ellipse\Handlers\RequestHandlerWithMiddleware
class allowing to wrap a middleware around a request handler.
<?php namespace App; use Ellipse\Handlers\FallbackRequestHandler; use Ellipse\Handlers\RequestHandlerWithMiddleware; // create Psr-15 middleware and request handler. $middleware = new SomeMiddleware; $handler = new FallbackRequestHandler($response); // Wrap the middleware around the request handler. $decorated = new RequestHandlerWithMiddleware($handler, $middleware); // The request goes through the middleware then hit the fallback request handler. $response = $decorated->handle($request);
Request handler with middleware stack
This package provides an Ellipse\Handlers\RequestHandlerWithMiddlewareStack
class allowing to wrap many middleware around a request handler in LIFO order.
<?php namespace App; use Ellipse\Handlers\FallbackRequestHandler; use Ellipse\Handlers\RequestHandlerWithMiddlewareStack; // create Psr-15 middleware and request handler. $middleware1 = new SomeMiddleware1; $middleware2 = new SomeMiddleware2; $handler = new FallbackRequestHandler($response); // Wrap the middleware around the request handler in LIFO order. $decorated = new RequestHandlerWithMiddlewareStack($handler, [ $middleware2, $middleware1, ]); // The request goes through middleware1, middleware2, then hit the fallback request handler. $response = $decorated->handle($request);
Request handler with middleware queue
This package provides an Ellipse\Handlers\RequestHandlerWithMiddlewareQueue
class allowing to wrap many middleware around a request handler in FIFO order.
<?php namespace App; use Ellipse\Handlers\FallbackRequestHandler; use Ellipse\Handlers\RequestHandlerWithMiddlewareQueue; // create Psr-15 middleware and request handler. $middleware1 = new SomeMiddleware1; $middleware2 = new SomeMiddleware2; $handler = new FallbackRequestHandler($response); // Wrap the middleware around the request handler in FIFO order. $decorated = new RequestHandlerWithMiddlewareQueue($handler, [ $middleware1, $middleware2, ]); // The request goes through middleware1, middleware2, then hit the fallback request handler. $response = $decorated->handle($request);