Laravel Pipeline Pattern Beyond Middleware | Mohamed Said [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ ](https://github.com/EG-Mohamed) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ home ](https://msaied.com) [ articles ](https://msaied.com/articles) The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware On this page 1. [ The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware ](#the-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware) 2. [ What the Pipeline Actually Does ](#what-the-pipeline-actually-does) 3. [ Typed Passables: Use a DTO ](#typed-passables-use-a-dto) 4. [ Writing a Pipe Class ](#writing-a-pipe-class) 5. [ Short-Circuiting the Pipeline ](#short-circuiting-the-pipeline) 6. [ Assembling the Pipeline as a Service ](#assembling-the-pipeline-as-a-service) 7. [ Testing with Pest ](#testing-with-pest) 8. [ Takeaways ](#takeaways) ![The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware](https://cdn.msaied.com/419/65618d839987270b780e652bfdf22cfe.png) #laravel #design-patterns #architecture #testing The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware ===================================================================== 13 Jul 2026 3 min read ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said Table of contents 1. [ 01 The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware ](#the-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware) 2. [ 02 What the Pipeline Actually Does ](#what-the-pipeline-actually-does) 3. [ 03 Typed Passables: Use a DTO ](#typed-passables-use-a-dto) 4. [ 04 Writing a Pipe Class ](#writing-a-pipe-class) 5. [ 05 Short-Circuiting the Pipeline ](#short-circuiting-the-pipeline) 6. [ 06 Assembling the Pipeline as a Service ](#assembling-the-pipeline-as-a-service) 7. [ 07 Testing with Pest ](#testing-with-pest) 8. [ 08 Takeaways ](#takeaways) The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware ------------------------------------------------------------------- Most Laravel developers know `Illuminate\Pipeline\Pipeline` only as the machinery that runs HTTP middleware. That's a shame — it's one of the cleanest abstractions in the framework, and it maps perfectly onto domain workflows: order processing, document ingestion, multi-step imports, and anything else that passes a single object through a sequence of transformations. ### What the Pipeline Actually Does At its core, `Pipeline::send($passable)->through($pipes)->thenReturn()` builds a nested closure stack and calls it. Each pipe receives the passable and a `$next` callable. That's it. No magic, no hidden state. ```php use Illuminate\Pipeline\Pipeline; $result = app(Pipeline::class) ->send($passable) ->through([ PipeA::class, PipeB::class, ]) ->thenReturn(); ``` The default method invoked on each class is `handle($passable, Closure $next)`. You can override this with `->via('process')` if your pipes already have a different contract. ### Typed Passables: Use a DTO Passing a plain array through a pipeline is asking for bugs. Use a mutable DTO so every pipe has a typed contract. ```php final class OrderImportContext { public function __construct( public readonly array $rawRow, public ?Product $product = null, public ?Customer $customer = null, public array $errors = [], ) {} public function addError(string $message): void { $this->errors[] = $message; } public function hasErrors(): bool { return count($this->errors) > 0; } } ``` Each pipe reads from and writes to this context. Nothing leaks outside the pipeline. ### Writing a Pipe Class ```php final class ResolveProduct { public function __construct( private readonly ProductRepository $products, ) {} public function handle(OrderImportContext $context, Closure $next): OrderImportContext { $sku = $context->rawRow['sku'] ?? null; if (! $sku) { $context->addError('Missing SKU'); return $next($context); // continue; downstream pipes may still run } $context->product = $this->products->findBySku($sku); if (! $context->product) { $context->addError("Unknown SKU: {$sku}"); } return $next($context); } } ``` Because pipes are resolved via the service container, constructor injection works out of the box. ### Short-Circuiting the Pipeline Sometimes you want to halt on the first error. Simply don't call `$next`: ```php public function handle(OrderImportContext $context, Closure $next): OrderImportContext { if ($context->hasErrors()) { return $context; // bail early, skip remaining pipes } // ... do work return $next($context); } ``` This is the same mechanism Laravel's own `CheckForMaintenanceMode` middleware uses. ### Assembling the Pipeline as a Service Don't scatter `app(Pipeline::class)` calls across your codebase. Wrap it: ```php final class OrderImportPipeline { private array $pipes = [ ResolveProduct::class, ResolveCustomer::class, ValidateQuantity::class, PersistOrder::class, ]; public function __construct( private readonly Pipeline $pipeline, ) {} public function run(array $rawRow): OrderImportContext { return $this->pipeline ->send(new OrderImportContext($rawRow)) ->through($this->pipes) ->thenReturn(); } } ``` Bind it in a service provider and inject it wherever needed. ### Testing with Pest Because each pipe is a plain class, you can test them in isolation: ```php it('adds an error when SKU is missing', function () { $pipe = new ResolveProduct( products: Mockery::mock(ProductRepository::class), ); $context = new OrderImportContext(rawRow: []); $result = $pipe->handle($context, fn ($ctx) => $ctx); expect($result->errors)->toContain('Missing SKU'); }); ``` And the full pipeline as an integration test: ```php it('persists a valid order row end-to-end', function () { $pipeline = app(OrderImportPipeline::class); $context = $pipeline->run(['sku' => 'WIDGET-1', 'qty' => 2, 'customer_id' => 1]); expect($context->hasErrors())->toBeFalse() ->and(Order::count())->toBe(1); }); ``` ### Takeaways - `Pipeline` is a first-class Laravel primitive — use it for any sequential, composable workflow. - A typed DTO passable eliminates silent type errors and makes each pipe self-documenting. - Pipes are container-resolved, so full DI is available without any extra wiring. - Short-circuit by returning early without calling `$next`; continue by always calling it. - Wrapping the pipeline in a dedicated service class keeps assembly logic in one place and makes the pipeline trivially swappable in tests. Found this useful? [ ](https://twitter.com/intent/tweet?url=https%3A%2F%2Fmsaied.com%2Farticles%2Fthe-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware&text=The+Pipeline+Pattern+in+Laravel%3A+Custom+Pipelines+Beyond+Middleware) [ ](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fmsaied.com%2Farticles%2Fthe-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware) Frequently Asked Questions ---------------------------- 3 questions Q01 Can I pass a pipeline instance through the service container and swap pipes per context? Yes. Bind your pipeline wrapper in a service provider and use contextual binding or a factory method to inject different pipe sets for different contexts — for example, a stricter validation pipe set for API imports versus a lenient one for admin bulk uploads. Q02 Is there a performance cost to using Pipeline over a plain foreach loop? The overhead is negligible for typical domain workflows. Pipeline builds a closure stack once per invocation, which adds microseconds. For tight loops processing thousands of rows per second, a plain loop is faster, but for most business logic the readability and testability gains outweigh any micro-benchmark difference. Q03 How do I handle exceptions thrown inside a pipe? Exceptions bubble up normally through the closure stack. Wrap your `thenReturn()` call in a try/catch at the call site, or add a dedicated exception-catching pipe at the start of the pipeline that wraps `$next($context)` in a try/catch and records the error on the context object. Continue reading More Articles --------------- [ View all ](https://msaied.com/articles) [ ![New in Laravel 13: First-Party Image Manipulation](https://cdn.msaied.com/427/504aed7f9f1c4a1cd411c7c4a4b6bc7c.png) Laravel 13 Image Manipulation PHP ### New in Laravel 13: First-Party Image Manipulation Laravel 13 introduces a first-party image manipulation feature, removing the need for third-party packages for... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 15 Jul 2026 3 min read Read ](https://msaied.com/articles/new-in-laravel-13-first-party-image-manipulation) [ ![Filament v4 Testing with Pest: Resources, Actions, and Form Assertions](https://cdn.msaied.com/426/a81430a378b2849b6fbecb8235b9119f.png) filament pest testing ### Filament v4 Testing with Pest: Resources, Actions, and Form Assertions A practical guide to testing Filament v4 panels using Pest — covering resource page assertions, table action d... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 15 Jul 2026 3 min read Read ](https://msaied.com/articles/filament-v4-testing-with-pest-resources-actions-and-form-assertions) [ ![Laravel Legacy Bridge: Carry Authenticated Sessions from a Legacy PHP App into Laravel](https://cdn.msaied.com/429/5abced4ee695d6c03e3ae41bbf2fe4bb.png) Laravel PHP Session Management ### Laravel Legacy Bridge: Carry Authenticated Sessions from a Legacy PHP App into Laravel Laravel Legacy Bridge is a package that reads a legacy session cookie, decodes the payload from the legacy dat... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 15 Jul 2026 4 min read Read ](https://msaied.com/articles/laravel-legacy-bridge-carry-authenticated-sessions-from-a-legacy-php-app-into-laravel) [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com)Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. Explore - [Home](https://msaied.com) - [Projects](https://msaied.com/projects) - [Articles](https://msaied.com/articles) - [Certificates](https://msaied.com/certificates) - [Contact](https://msaied.com#contact-section) Connect - [ hello@msaied.com ](mailto:hello@msaied.com) - [ +20 109 461 9204 ](tel:+201094619204) © 2026 Mohamed Said. All rights reserved. [ ](https://github.com/EG-Mohamed) [ ](https://www.linkedin.com/in/msaiedm/) [ ](https://wa.me/201094619204) [ ](mailto:hello@msaied.com) [ ](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view)