中文(繁體)
中文(繁體)
在編寫高性能或對時間敏感的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() 。
