函數原型
time_nanosleep(int $seconds, int $nanoseconds): true|array
參數說明
| 參數 | 類型 | 範圍 | 說明 |
$seconds | int | >= 0 | 延遲秒數 |
$nanoseconds | int | 0 ~ 999,999,999 | 延遲奈秒數(1 秒 = 109 奈秒) |
回傳值
- 成功:
true
- 失敗:
false
- 被訊號中斷:回傳關聯陣列
['seconds' => 剩餘秒, 'nanoseconds' => 剩餘奈秒]
平台限制
Windows 不支援此函數(PHP 官方文檔註明)。Windows 環境請改用 usleep()(微秒)或 hrtime() 配合忙等待(不推薦)。
使用範例
<?php
// 延遲 3.5 秒
if (time_nanosleep(3, 500_000_000) === true) {
echo "暫停 3.5 秒完成\n";
}
// 處理中斷
$remain = time_nanosleep(10, 0);
if (is_array($remain)) {
echo "被中斷,剩餘 {$remain['seconds']} 秒 {$remain['nanoseconds']} 奈秒\n";
}
?>
常見替代方案
| 函數 | 精度 | 跨平台 | 適用場景 |
sleep($sec) | 秒 | 是 | 粗略延遲 |
usleep($usec) | 微秒 | 是 | 次秒級延遲(最大 1 秒) |
time_nanosleep() | 奈秒 | 僅 Unix | 高精度科學計算、速率控制 |
hrtime(true) | 奈秒 | PHP 7.3+ 全平台 | 高精度計時、效能分析 |