如何捕捉socket_accept() 拋出的錯誤代碼與日誌

在使用PHP 進行基於Socket 的編程時， socket_accept()是一個關鍵函數，它用於接受來自客戶端的連接。然而，如果該函數調用失敗，可能會拋出錯誤，導致程序中斷或產生不可預期的行為。因此，捕捉這些錯誤並將其記錄在日誌中，對於調試和運維來說是非常必要的。

本文將詳細介紹如何捕捉socket_accept()函數的錯誤，並將其記錄到日誌文件中。

基礎示例

以下是一個基礎的Socket 服務端示例：

 <?php

$host = '0.0.0.0';
$port = 8080;

$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if ($socket === false) {
    error_log("socket_create() failed: " . socket_strerror(socket_last_error()) . "\n", 3, "/var/log/php_socket_error.log");
    exit;
}

if (!socket_bind($socket, $host, $port)) {
    error_log("socket_bind() failed: " . socket_strerror(socket_last_error($socket)) . "\n", 3, "/var/log/php_socket_error.log");
    exit;
}

if (!socket_listen($socket, 5)) {
    error_log("socket_listen() failed: " . socket_strerror(socket_last_error($socket)) . "\n", 3, "/var/log/php_socket_error.log");
    exit;
}

捕捉socket_accept() 錯誤

socket_accept()會在失敗時返回false 。為了捕捉錯誤代碼並記錄日誌，你可以如下處理：

 while (true) {
    $clientSocket = @socket_accept($socket);
    if ($clientSocket === false) {
        $errCode = socket_last_error($socket);
        $errMsg = socket_strerror($errCode);
        error_log("socket_accept() failed with error [$errCode]: $errMsg\n", 3, "/var/log/php_socket_error.log");

        // 根據需要可以選擇繼續或者終止循環
        continue;
    }

    // 接收到連接後的處理邏輯
    $msg = "Hello from server on http://m66.net\n";
    socket_write($clientSocket, $msg, strlen($msg));
    socket_close($clientSocket);
}

在這段代碼中：

• 使用了@運算符來抑制socket_accept()拋出的默認警告；

• socket_last_error()獲取最近一次Socket 操作的錯誤代碼；

• socket_strerror()將錯誤代碼轉化為人類可讀的字符串；

• error_log()將錯誤寫入/var/log/php_socket_error.log文件。

注意：確保你有權限寫入日誌文件路徑，並且日誌文件的父目錄存在。

提升可讀性和維護性

你也可以將錯誤日誌封裝成一個函數，以便復用和統一格式輸出：

 function log_socket_error($socket, $context = '') {
    $errCode = socket_last_error($socket);
    $errMsg = socket_strerror($errCode);
    $timestamp = date('Y-m-d H:i:s');
    $logEntry = "[$timestamp] [$context] Error [$errCode]: $errMsg\n";
    error_log($logEntry, 3, "/var/log/php_socket_error.log");
}

使用方式如下：

 $clientSocket = @socket_accept($socket);
if ($clientSocket === false) {
    log_socket_error($socket, 'socket_accept');
    continue;
}

結語

通過上述方法，你可以在使用socket_accept()時有效捕捉和記錄錯誤，避免服務端靜默失敗或調試困難。同時，將日誌寫入文件也便於後續的運維排查和自動監控系統的集成。在實際生產環境中，也建議使用類似ELK 或其他集中式日誌方案進一步增強可觀測性。