https://github.com/bermudaphp/psr15factory
Makes middleware for psr-15 based application
https://github.com/bermudaphp/psr15factory
http middleware middleware-factory middleware-resolver middlewares php php-middleware php8 php84 psr-15
Last synced: 3 months ago
JSON representation
Makes middleware for psr-15 based application
- Host: GitHub
- URL: https://github.com/bermudaphp/psr15factory
- Owner: bermudaphp
- License: mit
- Created: 2020-04-20T16:05:19.000Z (about 5 years ago)
- Default Branch: v3
- Last Pushed: 2025-04-10T13:46:03.000Z (3 months ago)
- Last Synced: 2025-04-10T14:02:13.703Z (3 months ago)
- Topics: http, middleware, middleware-factory, middleware-resolver, middlewares, php, php-middleware, php8, php84, psr-15
- Language: PHP
- Homepage:
- Size: 229 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Installation
```bash
composer require bermudaphp/psr15factory
```
## Usage
```php
$factory = new MiddlewareFactory($containerInterface, $responseFactoryInterface);
```
## Classname
```php
class MyMiddleware implements MiddlewareInterface
{
private ResponseFactoryInterface $factory;
public function __construct(ResponseFactoryInterface $factory)
{
$this->factory = $factory;
}
public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
{
return $this->factory->createResponse(200, 'OK!');
}
}
$middleware = $factory->make(MyMiddleware::class);
$middleware instanceof MyMiddleware::class // true
class MyHandler implements RequestHandlerInterface
{
private ResponseFactoryInterface $factory;
public function __construct(ResponseFactoryInterface $factory)
{
$this->factory = $factory;
}
public function handle(ServerRequestInterface $request): ResponseInterface
{
return $this->factory->createResponse(200, 'OK!');
}
}
$middleware = $factory->make(MyHandler::class);
$middleware instanceof MiddlewareInterface::class // true
```
## Lazy Middleware
```php
$middleware = $factory->make(static function(ContainerInterface $c) use ($uri, $permanent): RedirectMiddleware
{
return new RedirectMiddleware($uri, $c->get(ResponseFactoryInterface::class), $permanent);
});
$middleware instanceof MiddlewareInterface::class // true
$middleware instanceof RedirectMiddleware::class // true
```
## Callable Middleware
```php
$middleware = $factory->make(static function(ServerRequestInterface $req): ResponseInterface
{
return new TextResponse('Hello World!');
});
$middleware instanceof MiddlewareInterface::class // true
class MyCallback
{
public function methodName(ServerRequestInterface $req) : ResponseInterface
{
return new TextResponse('Hello World');
}
}
$middleware = $factory->make('MyCallback::methodName');
$middleware instanceof MiddlewareInterface::class // true
```
## Invokable Middleware
```php
class Invokable
{
public function __invoke(string $name) : ResponseInterface
{
return new TextResponse('Hello, '. $name);
}
}
$factory->make('Invokable::class') instanceof MiddlewareInterface::class ; // true
```
## Request Args Middleware
```php
$middleware = $factory->make(static function(#[Bermuda\MiddlewareFactory\Attribute\RequestAttribute('name')] string $name): ResponseInterface
{
return new TextResponse(sprintf('Hello, %s!', $name));
});
$response = $middleware->process((new ServerRequest())->withAttribute('name', 'John'), $requestHandler);
$response instanceof TextResponse // true
```
## Availables callback method signature
```php
function(): ResponseInterface ;
function(ContainerInterface $container): ResponseInterface ;
function(mixed ... $args): ResponseInterface ;
function(ServerRequestInterface $req): ResponseInterface ;
function(ServerRequestInterface $req, RequestHandlerInterface $handler): ResponseInterface ;
function(ServerRequestInterface $req, ResponseInterface $resp, callable $next): ResponseInterface ;
function(ServerRequestInterface $req, callable $next): ResponseInterface ;
```