Laravel并发请求如何利用Swoole协程实现非阻塞【进阶】-php教程-PHP中文网

laravel原生不支持协程，需通过octane或swoole常驻进程启用；必须切换至协程环境（如octane:start）、使用swoole协程客户端（mysql/http/redis等），并显式处理变量传递与并发控制。

laravel并发请求如何利用swoole协程实现非阻塞【进阶】

Laravel 本身不支持协程，并发请求要真正实现非阻塞，必须脱离 FPM 环境，改用 Swoole 或 Octane 启动常驻进程，并在其中使用 Swoole 原生协程组件——不是改写 Laravel 代码，而是绕过它的同步瓶颈，在关键 IO 环节替换为协程化操作。

运行环境必须切换到协程上下文

在 Apache、Nginx + PHP-FPM 或 php artisan serve 下，任何 go()、Swoole\Coroutine\MySQL 都会直接报错。协程只能在以下三种场景安全启用：

用 laravel/octane:start 启动（底层默认使用 Swoole）
通过 Swoole\Http\Server 手动搭建服务并监听请求
在命令行脚本中调用 Swoole\Coroutine\run(function () { ... })

验证是否就绪：执行 php -m | grep swoole 有输出，且 Octane 已启动成功（ps aux | grep octane 可见 worker 进程）。

IO 操作必须换用协程客户端

Laravel 的 Eloquent、DB Facade、Redis Facade、Guzzle 默认都是同步阻塞的，它们不会自动“协程化”。必须显式替换为 Swoole 提供的协程版本：

数据库查询 → 改用 Swoole\Coroutine\MySQL（不能混用 PDO）
HTTP 请求 → 改用 Swoole\Coroutine\Http\Client（不用 curl_exec 或 Guzzle 同步模式）
Redis 操作 → 改用 Swoole\Coroutine\Redis（禁用 Predis 或 PhpRedis 同步扩展）
DNS 查询 → 用 Swoole\Coroutine::gethostbyname() 替代 gethostbyname()

注意：这些客户端需手动 connect，且连接不能跨协程复用（除非你管理连接池），否则易触发连接泄漏。

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

并发控制与变量传递要显式处理

协程间不共享局部变量作用域，闭包中若需收集结果，必须用 use 显式传参并加引用：

错误写法：go(function () use ($item) { $results[] = $item; }); → $results 不会被修改
正确写法：go(function () use ($item, &$results) { $results[] = $item; });
高并发时建议限制协程数量，例如用 channel 控制最大并发 10 个 HTTP 请求，避免 Redis 连接数暴涨

常见陷阱：在 Horizon 队列任务里无节制 go()，每个协程新建一个 Redis 实例，导致连接数瞬间破千——这不是优化，是资源风暴。

实际并发请求示例（Octane 环境下）

比如需要同时查 3 个外部 API 并合并结果，可这样写：

定义协程函数封装单次请求：function fetchApi($url) { $client = new Swoole\Coroutine\Http\Client(...); $client->get($url); return $client->body; }
并发发起：go(fn() => $res1 = fetchApi('https://api.a')); go(fn() => $res2 = fetchApi('https://api.b')); go(fn() => $res3 = fetchApi('https://api.c'));
用 channel 或引用变量统一收口，最后返回聚合数据

整个过程不阻塞主线程，耗时约等于最慢那个请求，而非三者之和。