wait 和 waitid 不是 swoole 的 api，而是 linux 系统调用；swoole 不封装也不推荐直接使用，真正相关的是 event::wait()——其作用仅为启动事件循环，与进程等待无关。
Wait 和 waitid 都不是 Swoole 的 API
直接说结论：Wait 和 waitid 在 Swoole 扩展中根本不存在——它们是 Linux 系统调用（wait(2) / waitid(2)），属于 PHP 进程层面的底层 syscall，Swoole 本身不封装、不暴露、也不推荐你在应用层直接调用。
你看到这两个词混入 Swoole 上下文，大概率来自以下三种混淆场景：
- 误把 PHP 的
pcntl_wait()或pcntl_waitpid()当成 Swoole 方法（其实它们属于 pcntl 扩展） - 在阅读 Swoole 源码或调试日志时，看到内核 trace 中出现
waitid系统调用（比如 Manager 进程回收 Worker 时由内核触发） - 将 Swoole 的
Event::wait()错写/错读为Wait()（首字母大小写敏感，且无此函数）
真正该关注的是 Event::wait() —— 它和系统 wait 完全无关
Event::wait() 是 Swoole 自己实现的事件循环阻塞入口，名字虽带 “wait”，但和 wait(2) 没有任何关系：它不等待子进程，不读取 sigchld，也不操作任何进程状态。它的作用只有一个：让当前线程进入 epoll/kqueue 循环，监听注册的所有异步事件（如 socket 可读、定时器超时、DNS 查询完成等），直到所有待处理事件清空后才返回。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
常见误用点：
- 在协程环境中调用
Event::wait()：会破坏协程调度器，导致协程卡死（因为协程本应由Swoole\Coroutine::sleep()或co::run()驱动） - 在 Server 模式下调用：Swoole 主循环已自动运行，手动加
Event::wait()会导致进程 hang 住，无法响应请求 - 期望它回收子进程：它完全不处理
fork出来的子进程，pcntl_wait()才干这事
如果真要等子进程，用 pcntl_wait()，但得避开 Swoole 的坑
只有当你明确使用 pcntl_fork() 创建了子进程（比如在 onWorkerStart 中启动一个独立监控进程），才需要 pcntl_wait() 或 pcntl_waitpid()。此时注意：
- 不能在协程上下文中调用，否则会阻塞整个协程栈
- 必须配合
pcntl_signal(SIGCHLD, ...)使用，否则可能丢失sigchld信号 - Swoole 4.8+ 默认禁用
pcntl（因与协程调度冲突），需编译时加--enable-pcntl并确认pcntl_enabled()返回 true -
waitid()在 PHP 中无对应函数，PHP 层只能用pcntl_wait()或pcntl_waitpid()
最常被忽略的一点：Swoole 的 Worker 进程本身已是 fork 出来的子进程，其生命周期由 Manager 进程用系统级 waitpid() 管理——你写的业务代码不需要、也不应该介入这一层。
