如何使用socket_clear_error 函數清理socket_bind() 報錯後的錯誤信息？

在PHP 中使用socket 編程時， socket_bind()函數用於將一個socket 綁定到一個指定的地址和端口。然而，在實際開發過程中， socket_bind()可能會因為端口被佔用、權限不足或者地址格式錯誤等原因報錯。報錯之後，錯誤信息會一直保留在socket 的錯誤隊列中，可能會影響後續的socket 操作。

為了解決這個問題，PHP 提供了socket_clear_error()函數，用來清理socket 相關的錯誤信息，確保後續的操作不會被舊的錯誤狀態影響。

一、socket_bind() 報錯的常見場景

<?php
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    die("創建 socket 失敗: " . socket_strerror(socket_last_error()));
}

// 試圖綁定一個已經被佔用的端口
if (!socket_bind($socket, '127.0.0.1', 8080)) {
    echo "绑定失敗: " . socket_strerror(socket_last_error($socket)) . PHP_EOL;
}
?>

當端口8080已被佔用時， socket_bind()會返回false並且設置錯誤碼，通過socket_last_error()獲取錯誤碼，再用socket_strerror()獲取對應錯誤信息。

二、錯誤信息未清理的影響

如果socket_bind()報錯後沒有清理錯誤，後續使用該socket 的操作可能會繼續受到錯誤狀態的影響，導致程序邏輯混亂或者無法正確恢復。

三、使用socket_clear_error() 清理錯誤

socket_clear_error()函數用於清理指定socket 的錯誤狀態。如果沒有傳入socket 參數，則清理全局的socket 錯誤信息。

示例：

 <?php
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    die("創建 socket 失敗: " . socket_strerror(socket_last_error()));
}

if (!socket_bind($socket, '127.0.0.1', 8080)) {
    echo "绑定失敗: " . socket_strerror(socket_last_error($socket)) . PHP_EOL;
    
    // 清理 socket 的錯誤信息，避免後續影響
    socket_clear_error($socket);
}

// 之後可以繼續對 socket 進行其他操作
// ...
?>

通過調用socket_clear_error($socket); ，你可以將這個socket 上遺留的錯誤信息清除掉，讓它回到一個乾淨的狀態。

四、注意事項

• socket_clear_error()只會清理錯誤狀態，不會修復錯誤的原因，比如端口被佔用，需要開發者手動解決。

• 在多次操作中，建議在遇到錯誤後及時調用該函數，保證socket 對象的錯誤狀態不會影響後續邏輯。

• 如果你不傳入任何參數，則清理的是當前線程的所有socket 錯誤信息。

五、完整示例

<?php
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    die("創建 socket 失敗: " . socket_strerror(socket_last_error()));
}

if (!socket_bind($socket, '127.0.0.1', 8080)) {
    echo "绑定失敗: " . socket_strerror(socket_last_error($socket)) . PHP_EOL;
    socket_clear_error($socket); // 清理錯誤
}

// 繼續監聽或其他操作
if (!socket_listen($socket)) {
    echo "监听失敗: " . socket_strerror(socket_last_error($socket)) . PHP_EOL;
    socket_clear_error($socket);
}

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

總結來說， socket_clear_error()是處理socket 錯誤狀態時的一個重要工具，能讓你的socket 編程更加健壯，避免因歷史錯誤狀態導致的異常行為。