大网数据广告活动
PHP 语言与运行手册

pcntl_sigwaitinfo · 等待信号

· 52CE 我爱测

pcntl_sigwaitinfo() 函数暂停调用脚本的执行直到接收到 signals 参数中列出的某个信号。只要其中的一个信号已经在等待状态(比如:通过 pcntl_sigprocmask() 函数阻塞),pcntl_sigwaitinfo() 就回立刻返回。

pcntl_sigwaitinfo

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

pcntl_sigwaitinfo — 等待信号

说明

function pcntl_sigwaitinfo(array $signals, array &$info = []): int|false

pcntl_sigwaitinfo() 函数暂停调用脚本的执行直到接收到 signals 参数中列出的某个信号。只要其中的一个信号已经在等待状态(比如:通过 pcntl_sigprocmask() 函数阻塞),pcntl_sigwaitinfo() 就回立刻返回。

参数

signals

要等待的信号数组。

info

info 参数设置为数组,包含信号信息。

以下元素会为所有信号设置:

  • signo:信号编号
  • errno:错误编号
  • code:信号代码

下面元素可能会为 SIGCHLD 信号设置:

  • status:退出的值或信号
  • utime:用户消耗的时间
  • stime:系统(内核)消耗的时间
  • pid:发送进程ID
  • uid:发送进程的实际用户ID

信号 SIGILL, SIGFPE, SIGSEGV 和 SIGBUS 可能会被设置的元素:

  • addr:发生故障的内存位置

可能会为 SIGPOLL 信号设置的元素:

  • band:Band event
  • fd:文件描述符

返回值

成功时返回信号编号, 或者在失败时返回 false。

更新日志

版本 说明
8.4.0 如果 signal 为空,则抛出 ValueError。
8.4.0 如果 signal 的值不是 int,则抛出 TypeError。
8.4.0 如果 signal 的值无效,则抛出 ValueError。

示例

示例 #1 pcntl_sigwaitinfo() 示例

<?php
echo "Blocking SIGHUP signal\n";
pcntl_sigprocmask(SIG_BLOCK, array(SIGHUP));

echo "Sending SIGHUP to self\n";
posix_kill(posix_getpid(), SIGHUP);

echo "Waiting for signals\n";
$info = array();
pcntl_sigwaitinfo(array(SIGHUP), $info);
?>

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。