waitevent 是单次阻塞等待，非 eventloop 替代品；eventloop 才是 swoole 持续运行的事件中枢，由 server 或协程环境自动驱动，waitevent 仅用于无 server 的异步 cli 脚本末尾防止进程退出。
WaitEvent 是阻塞式事件等待，不是 EventLoop 的替代品
很多人看到 Swoole\Event::wait() 就以为它启动了一个“自己的 EventLoop”，其实不是。它只是调用底层的 swoole_event_wait() 进入一次阻塞等待，直到当前进程注册的所有异步事件（如 Swoole\Async\Redis 回调、定时器触发、文件读写完成）全部处理完毕，然后立即返回。它不循环重启，也不接管协程调度，更不会自动重入。
常见错误现象：
- 在
go(function () { ... });协程里调用Swoole\Event::wait()—— 没用，协程内本就不该阻塞主循环 - 多次连续调用
Swoole\Event::wait()试图“续命”—— 第二次调用会立刻返回，因为事件队列已空 - 和
swoole_timer_tick()混用却没理解生命周期 —— 定时器回调若注册在wait()之前，能触发；若在之后注册，根本来不及生效
EventLoop 是 Swoole 的运行心脏，由 Server 或协程环境自动驱动
真正意义上的 EventLoop 是 Swoole 启动后内置的、持续运行的事件分发中枢。它基于 epoll/kqueue，监听所有注册的 fd 和 timer，并按需唤醒协程、执行回调、调度定时器。你几乎不需要手动启动它 —— Swoole\Server->start()、Swoole\Http\Server->start()、甚至 go() 启动协程后调用 Co\Socket::recv()，都会隐式绑定到这个 Loop。
关键差异点：
-
Swoole\Event::wait()是单次、被动、脚本级的“收尾等待”；EventLoop 是持续、主动、框架级的“运行基座” - Server 模式下，EventLoop 由主进程长期持有并轮询；而
Event::wait()常用于 CLI 脚本或测试场景，无 Server 时维持进程不退出 - 协程中所有 I/O 操作（
Co\MySQL::query()、Co\Http\Client->get()）都依赖同一个 Loop，但它们的挂起/恢复由协程调度器控制，与Event::wait()无关
什么时候必须用 Event::wait()？只在无 Server 的异步 CLI 脚本里
如果你写的是普通 PHP 脚本（非 Server->start()），又用了 Swoole\Async\* 类（如 Swoole\Async\Redis、Swoole\Async\HttpClient），就必须加 Swoole\Event::wait()，否则脚本执行完就退出，回调根本没机会执行。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
示例场景：
- 命令行批量调用异步 HTTP 接口做探测，用
Swoole\Async\HttpClient发请求，最后靠Swoole\Event::wait()等全部响应回来 - 初始化阶段异步加载配置（如从 Redis 读取），不希望后续逻辑在配置没拿到前就跑
- 单元测试里模拟异步行为，避免 PHPUnit 进程提前结束
注意：Swoole\Coroutine 系列 API（如 Co\Redis）不依赖 Event::wait()，它们走协程调度，只要最外层有 EventLoop（比如你在 go() 里调用），就自然能跑通。
协程环境下误用 Event::wait() 反而会卡死
这是最容易被忽略的坑：在已存在活跃 EventLoop 的上下文中（比如 Server 的 onReceive 回调、或 go() 启动的协程里），再调用 Swoole\Event::wait()，会导致当前线程/协程彻底阻塞，无法响应任何新事件，整个 Loop 停摆。
典型表现：
- WebSocket 服务突然不响应新连接或消息
- HTTP Server 在某次请求后卡住，CPU 降为 0，日志停在某一行
- 定时器不再触发，
swoole_timer_after()注册后永远不回调
根本原因：EventLoop 是单线程模型，Event::wait() 是同步阻塞调用，它会抢占并独占当前线程的事件轮询权，破坏了协程让出-恢复的协作机制。这种用法只适用于“没有其他事件需要处理”的纯异步脚本结尾。
