必须显式调用 $loop->run() 启动事件循环,否则注册的定时器等异步任务不会执行;它阻塞当前线程,仅用于 cli 场景,不可在 fpm/web 服务器中使用。

ReactPHP 的 Event Loop 怎么启动才不卡死
不手动运行 run(),整个异步逻辑就只是“注册了但没执行”。常见错误是写完 $loop->addTimer(1, fn() => echo 'done'); 就结束脚本,结果什么也不输出——因为事件循环根本没跑起来。
必须显式调用 $loop->run(),且它会阻塞当前进程直到所有任务完成或被显式停止。别把它当成“后台线程”,它是单线程、协作式调度的核心。
- 只在脚本末尾或长期守护进程入口处调用一次
$loop->run() - 不要在 HTTP 请求处理中(比如 Laravel 或传统 PHP-FPM 场景)直接调用,会阻塞整个请求生命周期
- 调试时可加
$loop->stop()在某个回调里提前退出,避免无限等待
怎么用 addTimer 实现可靠定时任务
addTimer() 不是 cron 替代品,它依赖事件循环持续运行;一旦循环卡住(比如同步 I/O 阻塞),定时器就会延迟甚至失效。
典型误用:在定时回调里执行 file_get_contents() 或 mysqli_query() 这类同步操作,导致后续所有定时器集体偏移。
- 定时回调内只做轻量操作:发信号、改状态、触发另一个 Promise,重活交给
Promise+AsyncExecutor或子进程 - 需要精确间隔(如每 5 秒拉一次 API),用
addPeriodicTimer()而非反复addTimer() - 注意参数单位是秒(浮点数),
0.1表示 100ms,不是毫秒整数
$loop->addPeriodicTimer(5.0, function () use ($client) {
// 这里应返回 Promise,不阻塞
$client->request('GET', 'https://api.example.com/health')
->then(fn($res) => var_dump($res->getStatusCode()));
});
异步任务怎么真正“并发”执行而不串行
ReactPHP 没有“多线程”,所谓并发靠的是事件驱动 + 非阻塞 I/O。你写的多个 Promise 看似并行,实际是否真并发,取决于底层资源是否支持非阻塞(如 DNS 查询、HTTPS 握手、文件句柄)。
常见陷阱:用 React\Socket\Connector 连 HTTPS 服务却没配好 TLS,结果退化成同步连接,所有后续请求排队等。
- HTTP 客户端必须用
React\Http\Browser(自动处理非阻塞连接池和 TLS) - 数据库操作不能直连 MySQL,得用
reactphp/mysql或amphp/mysql这类原生异步驱动 - 文件读写要避开
fopen(),改用React\Stream\ReadableResourceStream包装非阻塞 fd - CPU 密集型任务(如 JSON 解析大文件)必须扔进
React\ChildProcess\Process,否则拖垮整个 loop
为什么 EventLoop 在 CLI 下正常,一放到 Web Server 就失效
ReactPHP 的 EventLoop 和传统 PHP Web 运行模型天然冲突。FPM、Apache mod_php、Swoole HTTP server 都有自己的主循环,强行嵌入 React 的 loop 会导致不可预测的 hang 或 segfault。
这不是配置问题,是架构级不兼容。试图在 index.php 里 new Loop → addTimer → run,只会让请求永远挂起,或者被超时强制 kill。
- ReactPHP 只适合纯 CLI 应用(长连接网关、爬虫调度器、WebSocket 后端)
- Web 接口层建议用 Swoole 或 RoadRunner 做协程服务器,再通过 IPC 或消息队列与 React 子进程通信
- 如果非要混用,只能把 React 逻辑封装为独立守护进程,Web 层只发命令(如 Redis Pub/Sub 或 Unix Socket)
最常被忽略的一点:loop 的时间精度受系统 epoll/kqueue/select 实现影响,Linux 上默认最小分辨率约 1–10ms,别指望它精准到微秒级调度。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











