pcntl_sigwaitinfo
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
pcntl_sigwaitinfo — 等待信号
说明
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。离线整理了版式、链接和媒体显示。
