0 follower

Final Class Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFactoryFailure

All Classes | Methods
InheritanceYiisoft\Queue\Middleware\FailureHandling\MiddlewareFactoryFailure
ImplementsYiisoft\Queue\Middleware\FailureHandling\MiddlewareFactoryFailureInterface

Creates a middleware based on the definition provided.

Public Methods

Hide inherited methods

Method Description Defined By
__construct() Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFactoryFailure
createFailureMiddleware() Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFactoryFailure

Method Details

Hide inherited methods

__construct() public method

public mixed __construct ( \Psr\Container\ContainerInterface $container, Yiisoft\Queue\Middleware\CallableFactory $callableFactory )
$container \Psr\Container\ContainerInterface

Container to use for resolving definitions.
$callableFactory Yiisoft\Queue\Middleware\CallableFactory 

                public function __construct(
    private readonly ContainerInterface $container,
    private readonly CallableFactory $callableFactory,
) {
}
createFailureMiddleware() public method

public Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFailureInterface createFailureMiddleware ( array|callable|Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFailureInterface|string $middlewareDefinition )
$middlewareDefinition array|callable|Yiisoft\Queue\Middleware\FailureHandling\MiddlewareFailureInterface|string

Middleware definition in one of the following formats:

  • A middleware object.
  • A name of a middleware class. The middleware instance will be obtained from container and executed.
  • A callable with function(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface signature.
  • A controller handler action in format [TestController::class, 'index']. TestController instance will be created and index() method will be executed.
  • A function returning a middleware. The middleware returned will be executed.

For handler action and callable typed parameters are automatically injected using dependency injection container. Current request and handler could be obtained by type-hinting for {@see \Yiisoft\Queue\Middleware\FailureHandling\ServerRequestInterface} and {@see \Yiisoft\Queue\Middleware\FailureHandling\RequestHandlerInterface}.
throws \Psr\Container\NotFoundExceptionInterface
throws \Psr\Container\ContainerExceptionInterface 

                public function createFailureMiddleware(
    MiddlewareFailureInterface|callable|array|string $middlewareDefinition
): MiddlewareFailureInterface {
    if ($middlewareDefinition instanceof MiddlewareFailureInterface) {
        return $middlewareDefinition;
    }
    if (is_string($middlewareDefinition)) {
        return $this->getFromContainer($middlewareDefinition);
    }
    return $this->tryGetFromCallable($middlewareDefinition)
        ?? $this->tryGetFromArrayDefinition($middlewareDefinition)
        ?? throw new InvalidMiddlewareDefinitionException($middlewareDefinition);
}