PHP pcntl_waitid 怎样等待子进程并读取退出状态

PHP 8.4 新增的 pcntl_waitid() 适合在父进程需要精确筛选子进程、读取状态信息，或者只观察状态而暂不回收时使用。最容易混淆的一点是：启用 WNOHANG 后，函数返回 true 既可能表示拿到了状态，也可能表示当前没有可用状态；不能只看布尔值就认定子进程已经退出。

官方地址：https://www.php.net/manual/en/function.pcntl-waitid.php

实际使用时，把 idtype 和 id 用来限定观察对象，把 flags 用来限定状态变化，把 info 当作结果容器；只有返回 false 时，才进入 pcntl_get_last_error() 的错误处理路径。

pcntl_waitid 解决的是什么问题

pcntl_waitpid() 主要返回被等待子进程的 PID，并把传统 wait 状态写入变量；pcntl_waitid() 则把状态信息写入 $info 数组。它的函数签名如下：

pcntl_waitid(
    int $idtype = P_ALL,
    ?int $id = null,
    array &$info = [],
    int $flags = WEXITED,
    array &$resource_usage = []
): bool

P_ALL 表示匹配任意子进程，P_PID 表示按 PID 匹配，P_PGID 表示按进程组匹配。Linux 还支持 P_PIDFD，但它要求调用方已经拿到对应的 PID 文件描述符。文章中的示例只围绕最常见的 P_PID 展开。

按 PID 等待退出并读取 info

先用 pcntl_fork() 创建一个子进程。父进程传入 P_PID、子进程 PID 和 WEXITED，调用会等待匹配的退出状态，并把信息写入 $info：

官方手册列出的 info 字段包括 signo、errno、code、status、pid、uid、utime 和 stime。其中 status 是退出值或信号，不能把它机械地当作 HTTP 状态码或业务结果；如果需要区分正常退出和信号终止，还应结合状态码语义或现有的进程控制函数判断。

WNOHANG 为什么会让 true 变得不够用

轮询场景通常不希望父进程一直阻塞，这时可以把 WNOHANG 与 WEXITED 按位或。函数会立即返回；如果当前没有匹配状态，返回值仍然可能是 true，所以要继续查看 $info 中有没有 pid：

如果把 true 直接翻译成“已经结束”，轮询器就会提前删除任务、释放资源或记录错误结果。更稳妥的判断顺序是：先判断返回值是否为 false，再检查 info.pid 是否存在，最后才读取 info.status。

WNOWAIT 用来预览状态，不负责最终回收

WNOWAIT 的含义是保留返回状态对应的进程，使它仍处于可等待状态。它适合“先查看，再由另一个明确的清理分支完成回收”的设计，但不适合被误用成“调用一次就完成了全部清理”。

是否使用 WNOWAIT，取决于状态观察与资源回收是否由同一个代码路径负责。如果没有清晰的第二次等待动作，就不要添加这个标志，否则容易留下未回收的子进程状态。

参数组合可以这样速查

false、ECHILD 和平台边界怎么处理

pcntl_waitid() 返回 false 时，调用 pcntl_get_last_error() 取得错误号，再用 pcntl_strerror() 转成可读文本。常见边界包括：没有可等待的子进程时出现 ECHILD；被信号中断时出现 EINTR；标志或 idtype/id 组合非法时出现 EINVAL。

还要注意版本与扩展条件：官方手册将 pcntl_waitid() 标为 PHP 8.4 起可用，且它属于 PCNTL 进程控制扩展。生产部署应让 CLI 的 PHP 版本、扩展加载状态和运行平台与开发环境一致；不要仅因为代码能解析就假定目标机器已经提供这些常量和函数。

最后记住三条判断规则

• 用 idtype 与 id 限定“等谁”，用 flags 限定“看哪种状态”。
• 启用 WNOHANG 后，true 不等于“已经拿到状态”，要检查 info.pid。
• 只有 false 才进入 errno 诊断；使用 WNOWAIT 时必须安排后续回收。

相关问题

pcntl_waitid 和 pcntl_waitpid 有什么区别？ 前者把更完整的状态信息写入数组，并用 idtype/id 选择对象；后者返回子进程 PID，并把传统状态写入变量。

WNOHANG 返回 true 是不是子进程结束了？ 不一定。没有可用状态时也可能返回 true，应检查 info 是否包含 pid。

什么时候不应使用 WNOWAIT？ 当当前路径没有后续明确的等待与回收动作时，不要使用它。