Laravel 13.x 中文文档

主题

并发 ​

简介 ​

有时你可能需要执行几个互不依赖的慢任务。在许多情况下，通过并发执行任务可以实现显著的性能提升。Laravel 的 Concurrency 门面提供了一个简单、方便的 API 来并发执行闭包。

工作原理 ​

Laravel 通过序列化给定的闭包并将它们分派到隐藏的 Artisan CLI 命令来实现并发，该命令反序列化闭包并在其自己的 PHP 进程中调用它。闭包被调用后，结果值被序列化回父进程。

Concurrency 门面支持三种驱动程序：process（默认）、fork 和 sync。

fork 驱动程序相比默认的 process 驱动程序提供了更好的性能，但它只能在 PHP 的 CLI 上下文中使用，因为 PHP 不支持在 Web 请求期间进行分叉。在使用 fork 驱动程序之前，你需要安装 spatie/fork 包：

shell
composer require spatie/fork

sync 驱动程序主要用于测试期间，当你想禁用所有并发并简单地在父进程中按顺序执行给定的闭包时。

运行并发任务 ​

要运行并发任务，可以调用 Concurrency 门面的 run 方法。run 方法接受一个闭包数组，这些闭包应该在子 PHP 进程中同时执行：

php
use Illuminate\Support\Facades\Concurrency;
use Illuminate\Support\Facades\DB;

[$userCount, $orderCount] = Concurrency::run([
    fn () => DB::table('users')->count(),
    fn () => DB::table('orders')->count(),
]);

要使用特定的驱动程序，可以使用 driver 方法：

php
$results = Concurrency::driver('fork')->run(...);

或者，要更改默认的并发驱动程序，你应该通过 config:publish Artisan 命令发布 concurrency 配置文件并更新文件中的 default 选项：

shell
php artisan config:publish concurrency

延迟并发任务 ​

如果你想并发执行一组闭包，但对这些闭包返回的结果不感兴趣，你应该考虑使用 defer 方法。当调用 defer 方法时，给定的闭包不会立即执行。相反，Laravel 将在 HTTP 响应发送给用户后并发执行闭包：

php
use App\Services\Metrics;
use Illuminate\Support\Facades\Concurrency;

Concurrency::defer([
    fn () => Metrics::report('users'),
    fn () => Metrics::report('orders'),
]);