在服務監控、依賴服務健康檢查、防火牆驗證等場景,需要從 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
?>
傳統 socket_connect 阻塞模式無法精確控制超時(受系統預設 TCP 超時影響,通常 75 秒)。非阻塞模式下,socket_connect 立即返回,再用 socket_select 監聽寫就緒事件,實現毫秒級超時控制。
連接完成後(無論成功或被拒),Socket 都會變為可寫。必須通過 socket_get_option($socket, SOL_SOCKET, SO_ERROR) 獲取真實錯誤碼區分「開放」與「拒絕連接」。
| 錯誤碼常量 | 含義 | 狀態 |
|---|---|---|
| 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 端口檢測的標準可靠方案。封裝為可復用類後,可輕鬆集成到監控系統、部署腳本、服務發現健康檢查等場景。