如何正確搭配使用socket_clear_error() 和socket_last_error() 函數？

M66 2025-06-29

在PHP 中進行網絡編程時， socket_last_error()和socket_clear_error()是兩個非常重要的函數，主要用於管理和處理socket 連接中的錯誤信息。正確搭配使用這兩個函數，能夠幫助開發者更高效地捕獲並處理錯誤，提升程序的健壯性。本文將詳細講解這兩個函數的作用及正確使用方法，並通過示例代碼加深理解。

一、函數簡介

socket_last_error(resource $socket = null): int
該函數用於獲取指定socket 連接的最後一個錯誤代碼。如果沒有傳入socket 參數，則返回全局的最後錯誤代碼。這個錯誤代碼是一個整數，代表不同的錯誤類型。
socket_clear_error(resource $socket = null): void
該函數用於清除指定socket 連接上的錯誤狀態。如果不傳入socket 參數，則清除全局的錯誤狀態。清除錯誤後，再次調用socket_last_error()將返回0，表示沒有錯誤。

二、為什麼要搭配使用這兩個函數？

在進行socket 操作時，錯誤信息會一直保存在socket 的錯誤狀態中，如果不及時清除，後續調用socket_last_error()會持續返回之前的錯誤，導致無法區分新舊錯誤。

因此，推薦的做法是：

先調用socket_last_error()獲取當前錯誤狀態。
根據錯誤碼進行相應處理。
處理完成後調用socket_clear_error()清除錯誤，確保後續調用能準確獲取新的錯誤狀態。

三、示例代碼

<?php
// 創建一個 TCP socket
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

if ($socket === false) {
    echo "創建 socket 失敗，錯誤碼: " . socket_last_error() . "\n";
    socket_clear_error(); // 清除全局錯誤狀態
    exit;
}

// 嘗試連接到指定服務器和端口
$result = socket_connect($socket, 'm66.net', 80);

if ($result === false) {
    $errorCode = socket_last_error($socket);
    echo "连接失敗，錯誤碼: {$errorCode}\n";

    // 根据錯誤碼做不同处理，比如重試或記錄日誌
    // ...

    socket_clear_error($socket); // 清除 socket 錯誤狀態，避免影響後續操作
} else {
    echo "連接成功！\n";
}

// 關閉 socket
socket_close($socket);
?>

四、注意事項

錯誤狀態是和socket 資源綁定的，因此在調用時最好明確傳入對應的socket 資源，避免使用全局錯誤狀態，特別是在多socket 連接場景中。
及時清除錯誤狀態，避免錯誤信息被重複讀取，導致判斷錯誤。
如果你在處理完錯誤後不清除狀態，後續調用socket_last_error()可能會返回舊錯誤碼，影響程序邏輯。

五、小結

使用socket_last_error()獲取當前socket 的最後錯誤碼。
處理完錯誤後調用socket_clear_error()清除錯誤狀態。
傳入具體的socket 資源，避免混淆全局和局部錯誤狀態。

正確搭配使用這兩個函數，可以讓PHP socket 編程更加健壯和易於調試。