Laravel Concurrency Facade & Process Pools | 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) Laravel Concurrency Facade and Process Pools for Parallel Work On this page 1. [ Why Concurrency Matters in a Synchronous Framework ](#why-concurrency-matters-in-a-synchronous-framework) 2. [ The Concurrency Facade ](#the-concurrency-facade) 3. [ Handling Failures Gracefully ](#handling-failures-gracefully) 4. [ Driver Awareness ](#driver-awareness) 5. [ Process Pools for External Commands ](#process-pools-for-external-commands) 6. [ Limiting Concurrency ](#limiting-concurrency) 7. [ Concurrency vs. Queues: When to Choose What ](#concurrency-vs-queues-when-to-choose-what) 8. [ Production Checklist ](#production-checklist) 9. [ Key Takeaways ](#key-takeaways) ![Laravel Concurrency Facade and Process Pools for Parallel Work](https://cdn.msaied.com/204/995e35bbe76f87b94ee261d7f7c5f3dd.png) #laravel #concurrency #performance #php Laravel Concurrency Facade and Process Pools for Parallel Work ================================================================ 16 Jun 2026 4 min read ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said Table of contents 9 sections 1. [ 01 Why Concurrency Matters in a Synchronous Framework ](#why-concurrency-matters-in-a-synchronous-framework) 2. [ 02 The Concurrency Facade ](#the-concurrency-facade) 3. [ 03 Handling Failures Gracefully ](#handling-failures-gracefully) 4. [ 04 Driver Awareness ](#driver-awareness) 5. [ 05 Process Pools for External Commands ](#process-pools-for-external-commands) 6. [ 06 Limiting Concurrency ](#limiting-concurrency) 7. [ 07 Concurrency vs. Queues: When to Choose What ](#concurrency-vs-queues-when-to-choose-what) 8. [ 08 Production Checklist ](#production-checklist) 9. [ 09 Key Takeaways ](#key-takeaways) Why Concurrency Matters in a Synchronous Framework -------------------------------------------------- Laravel is built on a synchronous request/response cycle. That works beautifully for most CRUD work, but it becomes a bottleneck the moment you need to call three external APIs, crunch two independent data sets, or generate several reports before returning a response. The naive solution is to fire jobs and poll — but that adds latency, infrastructure, and complexity. Laravel 11 shipped a first-class answer: the **Concurrency facade** backed by a fork-based driver, and the mature **Process facade** with pool support. Together they let you express parallel work as plain PHP closures and collect the results synchronously. --- The Concurrency Facade ---------------------- The `Concurrency` facade (available since Laravel 11.x) forks the current PHP process for each task, runs them in parallel, and merges the results. ```php use Illuminate\Support\Facades\Concurrency; [$users, $revenue, $churn] = Concurrency::run([ fn () => User::query()->count(), fn () => Order::query()->sum('total'), fn () => $this->churnService->rate(), ]); ``` Each closure runs in its own forked child process. The parent blocks until all children finish, then returns an array of results in the same order as the input. ### Handling Failures Gracefully If a child throws, the exception is serialized back to the parent and re-thrown. Wrap individual tasks when partial failure is acceptable: ```php $results = Concurrency::run([ fn () => $this->fetchFromServiceA(), function () { try { return $this->fetchFromServiceB(); } catch (\Throwable $e) { return null; // degrade gracefully } }, ]); ``` ### Driver Awareness The default driver uses `pcntl_fork`. On environments without `pcntl` (Windows, some shared hosts) Laravel falls back to a synchronous driver — tasks run sequentially. Always verify `extension_loaded('pcntl')` in your production environment. ```php // config/concurrency.php (published via artisan vendor:publish) 'default' => env('CONCURRENCY_DRIVER', 'fork'), ``` --- Process Pools for External Commands ----------------------------------- When the parallel work involves shelling out — running ffmpeg, a Python script, or a CLI tool — the `Process` facade's pool API is the right tool. ```php use Illuminate\Support\Facades\Process; $pool = Process::pool(function ($pool) use ($files) { foreach ($files as $file) { $pool->command("ffmpeg -i {$file} -vn output/{$file}.mp3"); } })->start(); $results = $pool->wait(); foreach ($results as $result) { if ($result->failed()) { logger()->error($result->errorOutput()); } } ``` `start()` launches all processes immediately. `wait()` blocks until every process exits and returns a `ProcessResultCollection`. ### Limiting Concurrency Unbounded pools will exhaust file descriptors and CPU. Use a chunked approach: ```php foreach (array_chunk($files, 5) as $batch) { Process::pool(function ($pool) use ($batch) { foreach ($batch as $file) { $pool->command("convert {$file}"); } })->start()->wait(); } ``` --- Concurrency vs. Queues: When to Choose What ------------------------------------------- | Scenario | Best tool | |---|---| | Parallel API calls in a request | `Concurrency::run()` | | CPU-bound shell commands | `Process::pool()` | | Work that can be deferred | Queue jobs | | Long-running or retryable work | Horizon + jobs | The Concurrency facade is **synchronous from the caller's perspective** — the HTTP response waits. Use it only when the combined parallel time is shorter than sequential time and the total wall-clock time is still acceptable for a web request (typically under 10 seconds). --- Production Checklist -------------------- - Confirm `pcntl` is enabled on every app server and in your Docker image. - Child processes inherit the parent's database connections — connections are **not** automatically re-established. Call `DB::reconnect()` at the top of each closure if you query the database inside a forked task. - Memory is copied on fork (copy-on-write). Large in-memory collections before the fork inflate each child's footprint. - Set `max_execution_time` and process timeouts defensively to avoid zombie processes. --- Key Takeaways ------------- - `Concurrency::run()` forks PHP processes for parallel closure execution and returns results in order. - `Process::pool()` runs external commands in parallel; `wait()` collects all results. - Both tools are synchronous from the caller's view — they block until all work completes. - Re-establish database connections inside forked closures to avoid shared-socket corruption. - Fall back to queues for work that is deferrable, long-running, or needs retry semantics. Found this useful? [ ](https://twitter.com/intent/tweet?url=https%3A%2F%2Fmsaied.com%2Farticles%2Flaravel-concurrency-facade-and-process-pools-for-parallel-work&text=Laravel+Concurrency+Facade+and+Process+Pools+for+Parallel+Work) [ ](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fmsaied.com%2Farticles%2Flaravel-concurrency-facade-and-process-pools-for-parallel-work) Frequently Asked Questions ---------------------------- 3 questions Q01 Does the Concurrency facade share the database connection with child processes? Yes — forked children inherit the parent's open sockets. You must call DB::reconnect() (and Redis::reconnect() if applicable) at the start of each closure to get a fresh connection, otherwise you risk corrupted responses from a shared socket. Q02 Can I use the Concurrency facade on Laravel Octane? With caution. Octane workers are long-lived, and forking inside a persistent worker can cause unexpected state inheritance. Test thoroughly and prefer the queue-based approach for Octane deployments unless you fully control what state exists before the fork. Q03 What happens if one task in Concurrency::run() takes much longer than the others? The parent waits for all children to finish, so the total wall-clock time equals the slowest task. There is no built-in timeout per task in the fork driver; wrap long-running closures with your own alarm signal or pcntl_alarm if you need a hard deadline. Continue reading More Articles --------------- [ View all ](https://msaied.com/articles) [ ![Laravel Eloquent Global Scopes: Pitfalls, Testing, and Composing Them Safely](https://cdn.msaied.com/211/8b9b19e7ecbf690b182ffbe6bffc9530.png) laravel eloquent testing ### Laravel Eloquent Global Scopes: Pitfalls, Testing, and Composing Them Safely Global scopes are powerful but easy to misuse. Learn how to write, test, and safely compose Eloquent global sc... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 16 Jun 2026 1 min read Read ](https://msaied.com/articles/laravel-eloquent-global-scopes-pitfalls-testing-and-composing-them-safely) [ ![Eloquent Custom Relations: Polymorphic Pivots, HasManyThrough Tricks, and Raw Join Relations](https://cdn.msaied.com/210/b47272214946c6adcd02ddf74b7df816.png) laravel eloquent database ### Eloquent Custom Relations: Polymorphic Pivots, HasManyThrough Tricks, and Raw Join Relations Beyond belongsTo and hasMany lies a set of underused Eloquent relation techniques. This guide covers custom re... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 16 Jun 2026 3 min read Read ](https://msaied.com/articles/eloquent-custom-relations-polymorphic-pivots-hasmanythrough-tricks-and-raw-join-relations) [ ![New in Laravel 12: Features, Helpers, and Upgrade Notes](https://cdn.msaied.com/209/c713447686bc1eb0a921b4027e4e4df8.png) laravel php upgrade ### New in Laravel 12: Features, Helpers, and Upgrade Notes Laravel 12 ships with a refined starter kit system, per-request context propagation, and several quality-of-li... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 16 Jun 2026 3 min read Read ](https://msaied.com/articles/new-in-laravel-12-features-helpers-and-upgrade-notes) [ ![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)