Laravel Concurrency Facade & Process Pools | Mohamed Said [Skip to content](#main) [ ![](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed SaidLaravel Backend Engineer ](https://www.msaied.com/public) - [Home](https://www.msaied.com/public) - [Projects](https://www.msaied.com/public/projects) - [Articles](https://www.msaied.com/public/articles) - [Certificates](https://www.msaied.com/public/certificates) - [About](https://www.msaied.com/public#about) [ Contact](https://www.msaied.com/public#contact) Menu Menu ---- Close - [HomeStart here](https://www.msaied.com/public) - [ProjectsCase studies](https://www.msaied.com/public/projects) - [ArticlesEngineering notes](https://www.msaied.com/public/articles) - [CertificatesCredentials](https://www.msaied.com/public/certificates) - [AboutHow I work](https://www.msaied.com/public#about) - [ContactGet in touch](https://www.msaied.com/public#contact) [Start a conversation](https://www.msaied.com/public#contact) [WhatsApp](https://wa.me/201094619204) [Email](mailto:hello@msaied.com) 1. [Home](https://www.msaied.com/public) 2. / 3. [Articles](https://www.msaied.com/public/articles) 4. / 5. Laravel Concurrency Facade and Process Pools for Parallel Work Laravel Concurrency Facade and Process Pools for Parallel Work =============================================================== Learn how Laravel's Concurrency facade and Process pools let you run independent tasks in parallel, cutting wall-clock time without reaching for a queue or a third-party library. ![](https://cdn.msaied.com/01M22N44A70A5MC2S599JP0MPH.webp) [Mohamed Said](https://www.msaied.com/public#person) Published 16 Jun 2026 · Updated 16 Jun 2026 · 4 min read ShareCopy linkCopied ![Laravel Concurrency Facade and Process Pools for Parallel Work](https://cdn.msaied.com/204/995e35bbe76f87b94ee261d7f7c5f3dd.png) 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) 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. - [laravel](https://www.msaied.com/public/articles?search=laravel) - [concurrency](https://www.msaied.com/public/articles?search=concurrency) - [performance](https://www.msaied.com/public/articles?search=performance) - [php](https://www.msaied.com/public/articles?search=php) Frequently asked questions --------------------------- 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. 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. 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. ![Mohamed Said](https://cdn.msaied.com/01M22N44A70A5MC2S599JP0MPH.webp)About the author ---------------- [Mohamed Said](https://www.msaied.com/public#person)Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. [About](https://www.msaied.com/public#about) [GitHub ↗](https://github.com/EG-Mohamed) [LinkedIn ↗](https://www.linkedin.com/in/msaiedm/) [WhatsApp ↗](https://wa.me/201094619204) [Email Address ↗](mailto:hello@msaied.com) [My CV ↗](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view) [Previous articleLaravel Enums as First-Class Citizens: Casts, Rules, and Eloquent Integration](https://www.msaied.com/public/articles/laravel-enums-as-first-class-citizens-casts-rules-and-eloquent-integration) [Next articleBlackfire & Xdebug Profiling in Laravel: Finding Real Bottlenecks](https://www.msaied.com/public/articles/blackfire-xdebug-profiling-in-laravel-finding-real-bottlenecks) 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) ### Have a technical challenge? Tell me what you’re building. I reply within two working days. [Start a conversation](https://www.msaied.com/public#contact) Related articles ----------------- [ ![](https://cdn.msaied.com/740/cce86edc21eddcbdd2f2454fadaf9c70.png) · 3 min read### The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware 5 Oct 2026 ](https://www.msaied.com/public/articles/the-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware-1) [ ![](https://cdn.msaied.com/739/2d6897fdcdcf090613f96f72a64b8a78.png) · 4 min read### MySQL Full-Text Search in Laravel: Indexes, Relevance Scoring, and Boolean Mode 4 Oct 2026 ](https://www.msaied.com/public/articles/mysql-full-text-search-in-laravel-indexes-relevance-scoring-and-boolean-mode) [ ![](https://cdn.msaied.com/738/073696a3fefe18bec825beec5ac658f5.png) · 4 min read### Laravel Queue Rate-Limited Middleware: Throttling Jobs Without Losing Work 4 Oct 2026 ](https://www.msaied.com/public/articles/laravel-queue-rate-limited-middleware-throttling-jobs-without-losing-work) Have a technical challenge? ---------------------------- Tell me what you’re building. I reply within two working days. [Discuss your project ↗](https://www.msaied.com/public#contact) © 2026 Mohamed Said · Built with Laravel, meant to last.Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. - [Home](https://www.msaied.com/public) - [Articles](https://www.msaied.com/public/articles) - [Certificates](https://www.msaied.com/public/certificates) - [GitHub](https://github.com/EG-Mohamed) - [LinkedIn](https://www.linkedin.com/in/msaiedm/) - [WhatsApp](https://wa.me/201094619204) - [Email Address](mailto:hello@msaied.com) - [My CV](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view) - [Sitemap](https://www.msaied.com/public/sitemap.xml)