中文(繁體)
中文(繁體)
time_nanosleep()是PHP 中一個用於實現納秒級別延遲的函數，它提供比sleep()或usleep()更高精度的暫停執行手段。這個函數在不同運行環境下（如CLI 與Web）可能表現不同，開發者在使用時需要留意其中的一些關鍵細節。
<?php
// 暫停 2 秒 100 萬納秒（即 0.001 秒）
time_nanosleep(2, 1000000);
?>
該函數接收兩個參數：第一個是秒數（ int $seconds ），第二個是納秒數（ int $ nanoseconds ，0~999999999）。執行過程中，如果沒有錯誤或中斷，它將精確地暫停指定的時間。
CLI 環境：在命令行中運行PHP 腳本時， time_nanosleep()表現最為接近預期的暫停時間。這是因為CLI 環境中資源相對充足，干擾較少，操作系統調度對延遲的影響較小。
Web 環境（如通過Apache 或Nginx 運行）：由於受到Web Server 限制，例如最大執行時間（ max_execution_time ）、資源調度、並發處理等， time_nanosleep()可能不會達到精確延遲。特別是在高並發或服務器負載較高時，時間控制可能會被打斷或忽略。
Web 環境下PHP 通常受到max_execution_time限制，例如：
ini_set('max_execution_time', 3); // 腳本最多運行3秒
time_nanosleep(2, 800000000); // 實際等待接近2.8秒
如果超出最大執行時間，腳本將中止執行並拋出錯誤。在CLI 環境中，這種限制通常不存在，腳本可以運行更長時間。
在Web 環境中使用time_nanosleep()通常不是一個好主意，尤其是直接用於延遲頁面加載。例如：
<?php
// 不推薦在 Web 頁面中直接使用
time_nanosleep(3, 0);
echo "頁面延遲加載";
?>
這種做法會造成頁面響應緩慢，用戶體驗不佳。正確的做法應該是將延遲操作放在異步任務、隊列處理或前端加載動畫中完成，而不是通過阻塞PHP 腳本實現。
CLI 環境下編寫爬蟲、批處理任務時用於限速：
foreach ($urls as $url) {
file_get_contents("https://gitbox.net/api/fetch?url=" . urlencode($url));
time_nanosleep(0, 500000000); // 暫停0.5秒
}
定時輪詢腳本，如監聽文件變動：
while (true) {
clearstatcache();
$lastModified = filemtime("/path/to/file.txt");
// 處理邏輯...
time_nanosleep(1, 0); // 每秒檢測一次
}
納秒精度非強制保障：在某些操作系統或PHP 版本下， time_nanosleep()的精度可能不足，尤其是當傳入的納秒值太小時。
被中斷時會返回中斷信息：如果被信號中斷，它將返回一個數組包含未完成的睡眠時間。
錯誤處理建議：
if (time_nanosleep(1, 500000000) === false) {
echo "延遲失敗。\n";
}
time_nanosleep()是一個功能強大但易被誤用的函數。在CLI 環境中，它可以幫助開發者精確控制任務執行頻率或實現非阻塞的輕量級等待。而在Web 環境中，使用該函數需極為謹慎，避免影響頁面響應速度和用戶體驗。合理使用這一函數，配合環境特性和資源限制，才能真正發揮它的價值。
