简体中文
简体中文
在编写高性能或对时间敏感的 PHP 应用程序时，有时我们需要程序在非常短暂的时间内暂停执行，比如几毫秒甚至更精细的微秒或纳秒级别。这种需求在处理精密定时控制、节流请求或与硬件交互时尤为重要。幸运的是，PHP 提供了一个内建函数 time_nanosleep()，可以实现精确到纳秒的暂停。本文将带你深入了解这个函数的用法、注意事项，并提供多个实际示例来帮助你灵活掌握。
time_nanosleep() 是 PHP 中的一个函数，用于将程序暂停指定的秒数和纳秒数。其函数签名如下：
bool time_nanosleep ( int $seconds , int $nanoseconds )
$seconds: 整型，表示需要暂停的秒数。
$nanoseconds: 整型，表示需要暂停的纳秒数（0 到 999999999 之间）。
这个函数可以用来暂停任意小于一秒的时间，从而实现子秒级别的延迟。
PHP 还有两个常用的暂停函数：sleep() 和 usleep()。它们之间的区别如下：
sleep(int $seconds)：只能精确到秒。
usleep(int $microseconds)：精确到微秒（百万分之一秒）。
time_nanosleep(int $seconds, int $nanoseconds)：支持精确到纳秒（十亿分之一秒）。
因此，当你需要更高精度的时间控制时，time_nanosleep() 是更优的选择。
下面是一个简单的使用示例，暂停 0.5 秒（即 500 毫秒）：
<?php
echo "Start: " . microtime(true) . PHP_EOL;
time_nanosleep(0, 500000000); // 暂停 0.5 秒
echo "End: " . microtime(true) . PHP_EOL;
?>
输出将类似于：
Start: 1716026901.12345
End: 1716026901.62346
可以看到，程序暂停了大约 0.5 秒。
假设你希望每 200 毫秒执行一次某段代码，可以用如下方式：
<?php
for ($i = 0; $i < 5; $i++) {
echo "Tick $i at " . microtime(true) . PHP_EOL;
time_nanosleep(0, 200000000); // 200 毫秒
}
?>
这种写法可以有效用于发送节流请求、定时输出日志、轮询传感器等场景。
time_nanosleep() 在某些系统中可能因信号中断（如 POSIX 信号）而提前返回，并返回 false。在这种情况下，可以使用循环重试机制。
<?php
$seconds = 0;
$nanoseconds = 250000000; // 250 毫秒
do {
$result = time_nanosleep($seconds, $nanoseconds);
} while ($result === false && ($error = error_get_last()) && strpos($error['message'], 'interrupted') !== false);
?>
虽然大多数普通应用不会遇到这种中断，但在多线程或高并发环境下，推荐加上这类保护。
假设你正在开发一个针对硬件设备的 API，需要每隔 1 毫秒轮询数据接口一次，可以这样写：
<?php
$url = 'https://gitbox.net/api/device/status';
for ($i = 0; $i < 1000; $i++) {
$response = file_get_contents($url);
echo "[$i] Response: $response" . PHP_EOL;
time_nanosleep(0, 1000000); // 1 毫秒
}
?>
这种写法可以在不造成 CPU 占用爆炸的情况下进行高频率的数据拉取。
time_nanosleep() 从 PHP 5 开始就可用，几乎在所有主流版本都可使用。
在 Windows 和类 UNIX 系统中都可以运行。
尽管它支持纳秒级传入，但实际上精度取决于系统时钟分辨率。在某些平台，最小精度可能仍是微秒级。
time_nanosleep() 是 PHP 中一个强大但常被忽视的函数。它为开发者提供了微妙控制程序暂停时间的能力，尤其适用于对时间控制要求高的任务。通过本教程的讲解和示例，你应该能掌握如何灵活地应用它来提升你应用程序的控制力与性能。只要注意使用中的中断处理与系统限制，就能在多种场景中安全、精确地使用 time_nanosleep()。
