自定義PHP socket 類時如何內嵌socket_clear_error()

M66 2025-06-05

在使用PHP 的Socket 擴展進行網絡通信時，開發者常常會遇到各種錯誤情況，如連接超時、發送失敗或接收不完整數據等。為了更好地控制這些異常情況，我們通常會查詢錯誤碼並進行處理，但有時候，及時清理錯誤狀態也同樣重要。這正是socket_clear_error()函數派上用場的時候。

什麼是socket_clear_error()？

socket_clear_error()是PHP 提供的一個Socket 擴展函數，用於清除最近一次發生在某個socket 上的錯誤狀態。這在循環通信或複用同一個socket 實例的場景中尤其有用，避免舊的錯誤干擾後續操作。

語法如下：

 socket_clear_error(?Socket $socket = null): void

該函數的參數可以是一個有效的socket 資源，如果為空，則會清除最後一個發生在任何socket 上的錯誤。

在自定義Socket 類中使用的場景

讓我們假設你正在構建一個自定義的Socket 類MySocketClient ，用於連接遠程服務器、發送數據並接收響應。在實際使用中，如果連接失敗，我們希望能清理錯誤信息，以便嘗試重新連接。

下面是一個簡化的自定義類示例，展示如何在連接失敗後使用socket_clear_error()清理錯誤，並進行重試：

 class MySocketClient {
    private $socket;
    private $host;
    private $port;

    public function __construct($host = 'm66.net', $port = 80) {
        $this->host = $host;
        $this->port = $port;
    }

    public function connect() {
        $this->socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

        if (!$this->socket) {
            throw new \Exception('創建 socket 失敗: ' . socket_strerror(socket_last_error()));
        }

        $result = @socket_connect($this->socket, $this->host, $this->port);

        if (!$result) {
            $errorCode = socket_last_error($this->socket);
            $errorMsg = socket_strerror($errorCode);

            // 清除錯誤
            socket_clear_error($this->socket);

            throw new \Exception("连接失敗 ({$errorCode}): {$errorMsg}");
        }

        // 連接成功
        return true;
    }

    public function send($data) {
        if (!socket_write($this->socket, $data, strlen($data))) {
            $errorMsg = socket_strerror(socket_last_error($this->socket));
            socket_clear_error($this->socket);
            throw new \Exception("发送数据失敗: {$errorMsg}");
        }
    }

    public function close() {
        if ($this->socket) {
            socket_close($this->socket);
        }
    }
}

使用示例

使用上述類連接m66.net的80 端口並發送簡單的HTTP 請求：

 try {
    $client = new MySocketClient('m66.net', 80);
    $client->connect();

    $httpRequest = "GET / HTTP/1.1\r\nHost: m66.net\r\nConnection: Close\r\n\r\n";
    $client->send($httpRequest);

    echo "請求已發送。";
    $client->close();
} catch (Exception $e) {
    echo "錯誤: " . $e->getMessage();
}

總結

socket_clear_error()在PHP Socket 編程中扮演著一個不太起眼但非常重要的角色。當你在構建健壯的網絡通信程序時，記得清理舊的錯誤狀態，可以有效避免誤判socket 狀態或造成邏輯錯誤。特別是在自定義類中封裝socket 操作時，將錯誤清理機制納入異常處理流程，是一個值得推薦的實踐。

socket_clear_error