array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.pcntl-sigwaitinfo.php', 1 => 'pcntl_sigwaitinfo', 2 => '等待信号', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'PCNTL 函数', ), 'prev' => array ( 0 => 'function.pcntl-sigtimedwait.php', 1 => 'pcntl_sigtimedwait', ), 'next' => array ( 0 => 'function.pcntl-strerror.php', 1 => 'pcntl_strerror', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/pcntl/functions/pcntl-sigwaitinfo.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pcntl_sigwaitinfo

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

pcntl_sigwaitinfo — 等待信号

说明

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);
?>

参见