README

PSR-15 middleware pipeline for the Componenta framework.

Installation

composer require componenta/pipeline

The package declares Componenta\Http\Middleware\PipelineConfigProvider in extra.componenta.config-providers. When componenta/composer-plugin is installed, the provider is added to the generated provider list automatically.

Related Packages

Usage

As a top-level handler

use Componenta\Http\Middleware\Pipeline;

$pipeline = new Pipeline(
    [$errorMiddleware, $authMiddleware, $routerMiddleware],
    fallbackHandler: $notFoundHandler,
);

$response = $pipeline->handle($request);

If no fallbackHandler is supplied, EmptyPipelineHandler is installed and throws RuntimeException on invocation — this surfaces misconfiguration of an empty pipeline.

Nested pipelines

A pipeline is itself a middleware, so pipelines compose:

$api = new Pipeline([$apiAuth, $apiRouter]);
$web = new Pipeline([$sessionMiddleware, $webRouter]);

$app = new Pipeline([$errorMiddleware], $notFoundHandler)
    ->pipe($api)
    ->pipe($web);

Via the factory

$pipeline = $factory->createMiddlewarePipeline(
    [$auth, $router],
    $notFoundHandler,
);

Behavior

• Middleware execute in registration order (FIFO).
• pipe() returns a new pipeline; the original is not modified.
• Returning a response from a middleware without calling the next handler halts the chain.
• Exceptions from middleware and terminal handlers propagate unchanged.

Errors