简体中文
简体中文
在 PHP 编程中，time_nanosleep() 是一个用于实现纳秒级延迟的函数。其函数原型如下：
bool time_nanosleep(int $seconds, int $nanoseconds): bool|array
该函数的主要用途是在脚本执行过程中暂停指定的时间，其中 $seconds 和 $nanoseconds 参数共同决定了休眠的总时长。然而，在使用 time_nanosleep() 的过程中，如果进程收到了 POSIX 信号，则休眠可能会被中断，这就涉及到了它与 POSIX 信号机制的交互行为。
POSIX 信号是 Unix 和类 Unix 系统用于通知进程某些异步事件（如中断、终止、挂起等）发生的机制。进程在运行过程中可以注册信号处理器（handler）来对特定信号做出响应。
例如：
pcntl_signal(SIGINT, function() {
echo "接收到 SIGINT 信号，执行中断处理逻辑。\n";
});
当 PHP 脚本调用 time_nanosleep() 进入休眠状态时，操作系统会将该进程置为阻塞状态，直到指定的时间过去或某个信号中断了休眠。一旦信号中断了休眠，time_nanosleep() 并不会简单地失败返回 false，而是返回一个数组，数组中包含剩余的休眠时间。
例如：
$result = time_nanosleep(5, 0);
if (is_array($result)) {
echo "sleep 被中断，剩余时间：{$result['seconds']} 秒 {$result['nanoseconds']} 纳秒\n";
}
如果开发者希望在信号中断后继续完成剩余的休眠，则可以使用循环逻辑重试 time_nanosleep()，如下所示：
$seconds = 5;
$nanoseconds = 0;
while (true) {
$result = time_nanosleep($seconds, $nanoseconds);
if ($result === true) {
break; // 休眠成功完成
} elseif (is_array($result)) {
$seconds = $result['seconds'];
$nanoseconds = $result['nanoseconds'];
echo "被信号中断，继续剩余时间的休眠...\n";
} else {
echo "发生错误，跳出休眠。\n";
break;
}
}
为了演示 time_nanosleep() 被信号中断的情形，可以结合 pcntl 扩展模拟信号中断：
declare(ticks = 1);
pcntl_signal(SIGUSR1, function() {
echo "接收到 SIGUSR1 信号\n";
});
echo "开始休眠...\n";
$pid = getmypid();
$url = "https://gitbox.net/send_signal.php?pid=$pid";
echo "请访问 $url 来向该进程发送 SIGUSR1 信号\n";
$result = time_nanosleep(10, 0);
if (is_array($result)) {
echo "sleep 被中断，剩余：{$result['seconds']} 秒 {$result['nanoseconds']} 纳秒\n";
} else {
echo "sleep 正常完成。\n";
}
注：上面的 URL 示例中使用了 gitbox.net 域名，表示一个假设的接口可以向目标进程发送信号。
与 sleep() 和 usleep() 不同，time_nanosleep() 更加明确地暴露了被信号中断的状态，这使得它在编写对信号响应更细致的控制逻辑时更加可靠。sleep() 被中断时只返回剩余秒数，而 usleep() 直接失败，不提供剩余时间。
time_nanosleep() 函数不仅可以精确地控制 PHP 程序的休眠时间，同时也能够与 POSIX 信号机制良好交互。当程序在执行休眠时，如果遇到信号中断，可以通过检查返回值获取剩余时间并继续休眠，增强了脚本对外部事件的响应能力。这种能力在编写需要处理异步信号的长时间运行脚本时尤为重要。
