如何判斷time_nanosleep 是否成功執行？

gitbox 2025-05-26

在PHP中， time_nanosleep函數用於讓程序暫停指定的秒數和納秒數，精度比sleep和usleep更高，適合對時間控制要求嚴格的場景。然而，在實際開發中，我們常常需要判斷這個函數是否成功執行，以及在失敗時如何妥善處理。

本文將詳細講解time_nanosleep函數的執行結果判斷方法，並提供合理的失敗處理示例。

一、 time_nanosleep函數簡介

bool|array time_nanosleep(int $seconds, int $nanoseconds)

$seconds ：暫停的秒數，整數。
$nanoseconds ：暫停的納秒數，整數，範圍為0~999,999,999。

返回值：

成功時返回true 。
如果被信號中斷，返回一個包含剩餘秒數和納秒數的數組。

二、如何判斷函數是否成功執行？

time_nanosleep的返回值有兩種可能：

返回true ：表示睡眠時間全部完成，函數正常結束。
返回數組：表示睡眠被信號中斷，數組包含'seconds'和'nanoseconds'鍵，表示剩餘未睡眠的時間。

因此判斷方式如下：

 $result = time_nanosleep(2, 500000000); // 睡眠2.5秒

if ($result === true) {
    echo "睡眠成功完成\n";
} elseif (is_array($result)) {
    echo "睡眠被信號中斷，剩餘秒數：" . $result['seconds'] . "，剩餘納秒數：" . $result['nanoseconds'] . "\n";
} else {
    echo "未知錯誤\n";
}

三、失敗處理策略

在睡眠被中斷的情況下，通常開發者會選擇重新調用time_nanosleep ，讓程序繼續睡眠剩餘的時間，從而保證總體睡眠時長的準確性。

示例代碼：

 function safe_nanosleep(int $seconds, int $nanoseconds): void {
    while (true) {
        $result = time_nanosleep($seconds, $nanoseconds);
        if ($result === true) {
            // 睡眠完成，退出循環
            break;
        } elseif (is_array($result)) {
            // 被信號中斷，繼續睡眠剩餘時間
            $seconds = $result['seconds'];
            $nanoseconds = $result['nanoseconds'];
        } else {
            // 其他異常情況，可以拋出異常或日誌記錄
            throw new RuntimeException('time_nanosleep執行失敗');
        }
    }
}

try {
    safe_nanosleep(1, 0);
    echo "安全睡眠完成\n";
} catch (RuntimeException $e) {
    echo "錯誤：" . $e->getMessage() . "\n";
}

四、總結

time_nanosleep執行成功返回true ，失敗（被信號中斷）返回剩餘時間數組。
通過判斷返回值類型，可以明確函數是否成功。
遇到中斷情況，使用循環遞歸睡眠剩餘時間是常見的處理方式。
適當捕獲異常或錯誤，保證程序穩定運行。

參考文檔可訪問：
https://gitbox.net/manual/en/function.time-nanosleep.php