萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 實現 TCP 端口連通性檢測的完整方案

需求

在服務監控、依賴服務健康檢查、防火牆驗證等場景,需要從 PHP 判斷目標 IP:Port 是否可達。本文提供基於 Socket 非阻塞連接的可靠實現,支援超時控制與狀態解析。

核心類實現

<?php
class TcpPortChecker {
    private $timeout;

    public function __construct(int $timeout = 5) {
        $this->timeout = $timeout;
    }

    /**
     * 檢測端口狀態
     * @param string $ip   目標 IP
     * @param int    $port 目標端口
     * @return string 狀態:open, closed, timeout, error
     */
    public function check(string $ip, int $port): string {
        $socket = @socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
        if ($socket === false) {
            return 'error: ' . socket_strerror(socket_last_error());
        }

        // 非阻塞模式發起連接
        socket_set_nonblock($socket);
        $connected = @socket_connect($socket, $ip, $port);

        // 連接可能即時成功(本地回環)或返回 false 等待
        if ($connected === false && socket_last_error($socket) !== SOCKET_EINPROGRESS) {
            socket_close($socket);
            return 'error: ' . socket_strerror(socket_last_error($socket));
        }

        // 使用 socket_select 等待寫就緒(連接完成)或超時
        $write = [$socket];
        $except = [$socket];
        $ready = @socket_select($read = null, $write, $except, $this->timeout);

        socket_set_block($socket); // 恢復阻塞模式

        if ($ready === false) {
            socket_close($socket);
            return 'error: ' . socket_strerror(socket_last_error($socket));
        }

        if ($ready === 0) {
            socket_close($socket);
            return 'timeout';
        }

        // 連接建立或失敗(如 ECONNREFUSED)會在 except 或 write 就緒
        $errorCode = socket_get_option($socket, SOL_SOCKET, SO_ERROR);
        socket_close($socket);

        if ($errorCode === 0) {
            return 'open';
        } elseif ($errorCode === ECONNREFUSED) {
            return 'closed';
        } else {
            return 'error: ' . socket_strerror($errorCode);
        }
    }
}

// 使用示例
$checker = new TcpPortChecker(3); // 3 秒超時
$result = $checker->check('192.168.1.100', 3306);
echo "MySQL 3306: $result\n"; // open / closed / timeout / error
?>

關鍵技術點解析

1. 非阻塞 + socket_select

傳統 socket_connect 阻塞模式無法精確控制超時(受系統預設 TCP 超時影響,通常 75 秒)。非阻塞模式下,socket_connect 立即返回,再用 socket_select 監聽寫就緒事件,實現毫秒級超時控制。

2. SO_ERROR 獲取真實錯誤碼

連接完成後(無論成功或被拒),Socket 都會變為可寫。必須通過 socket_get_option($socket, SOL_SOCKET, SO_ERROR) 獲取真實錯誤碼區分「開放」與「拒絕連接」。

3. 常見錯誤碼對照

錯誤碼常量含義狀態
0成功open
ECONNREFUSED (111)連接被拒絕(端口未監聽)closed
ETIMEDOUT (110)連接超時(防火牆丟包)timeout
EHOSTUNREACH (113)主機不可達(路由問題)error
EACCES (13)權限不足(非 root 掃描特權端口)error

批次檢測優化

需同時檢測大量 IP:Port 時,單進程串行太慢。可採用 stream_socket_client + stream_select 非阻塞 I/O 多路複用,或使用 swoole/workerman 協程並發,單進程可輕鬆支援萬級並發檢測。

總結

基於 Socket 非阻塞連接 + socket_select 超時控制是 PHP 實現 TCP 端口檢測的標準可靠方案。封裝為可復用類後,可輕鬆集成到監控系統、部署腳本、服務發現健康檢查等場景。

copyright © 萬盛學電腦網 all rights reserved