萬盛學電腦網

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

PHP Socket 函數大全:從底層創建到高級 I/O 多路複用完整速查表

PHP Socket 擴展提供了接近系統調用級別的網絡編程能力,適用於高性能服務器、自定義協議、長連接推送、微服務 RPC 等場景。本文匯總所有 socket_* 函數,按功能分類並附關鍵參數說明,作為開發手冊速查。

環境檢查

// php.ini
extension=sockets  // Windows: php_sockets.dll, Linux: sockets.so

// 運行時動態加載(不推薦生產用)
if (!extension_loaded('sockets')) {
    dl(PHP_OS_FAMILY === 'Windows' ? 'php_sockets.dll' : 'sockets.so');
}

函數分類速查表

類別函數說明
創建與連接socket_create(domain, type, protocol)創建 Socket 資源,返回 Socket 實例。domain: AF_INET/AF_INET6/AF_UNIX; type: SOCK_STREAM/SOCK_DGRAM/SOCK_RAW
socket_create_pair()創建一對相連的 Socket(用於進程間通信)
socket_bind(socket, address, port)綁定本地地址端口
socket_connect(socket, address, port)發起連接(阻塞/非阻塞)
監聽與接受socket_listen(socket, backlog)監聽連接,backlog 為內核等待隊列長度
socket_accept(socket)接受新連接,返回新 Socket 資源
socket_create_listen(port)快捷創建並監聽 IPv4 TCP Socket
數據收發socket_write(socket, buffer, length)發送數據,返回寫入字節數
socket_read(socket, length, type)讀取數據,type: PHP_BINARY_READ/PHP_NORMAL_READ
socket_recv(socket, buf, len, flags)從緩衝區接收,flags: MSG_PEEK/MSG_WAITALL/MSG_DONTWAIT
socket_send(socket, buf, len, flags)發送到已連接 Socket
socket_sendto(socket, buf, len, flags, addr, port)UDP 發送到指定地址
高級 I/Osocket_select(read, write, except, tv_sec, tv_usec)select 多路複用,監控多個 Socket 可讀/可寫/異常
socket_iovec_* 系列分散/聚合 I/O(readv/writev),零拷貝優化
socket_get_option / socket_set_option獲取/設置選項:SO_REUSEADDR, TCP_NODELAY, SO_RCVBUF 等
socket_shutdown(socket, how)關閉讀/寫/雙向(SHUT_RD/SHUT_WR/SHUT_RDWR)
地址與狀態socket_getpeername(socket, &addr, &port)獲取對端地址
socket_getsockname(socket, &addr, &port)獲取本地綁定地址
socket_last_error(socket)獲取最後錯誤碼
socket_strerror(errno)錯誤碼轉人類可讀字符串
阻塞模式socket_set_block(socket)設置阻塞模式(默認)
socket_set_nonblock(socket)設置非阻塞模式
socket_close(socket)關閉並釋放資源

典型 TCP 服務器骨架(非阻塞 + select)

$server = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
socket_set_option($server, SOL_SOCKET, SO_REUSEADDR, 1);
socket_bind($server, '0.0.0.0', 9501);
socket_listen($server, 128);
socket_set_nonblock($server);

$clients = [$server];
while (true) {
    $read = $clients;
    $write = $except = null;
    $num = socket_select($read, $write, $except, 1); // 1秒超時
    if ($num === false) { echo "select error: " . socket_strerror(socket_last_error()); break; }
    if ($num === 0) continue; // 超時繼續

    foreach ($read as $sock) {
        if ($sock === $server) {
            $client = socket_accept($server);
            socket_set_nonblock($client);
            $clients[] = $client;
            echo "New client: " . (int)$client . "\n";
        } else {
            $data = @socket_read($sock, 65535, PHP_BINARY_READ);
            if ($data === '' || $data === false) {
                $idx = array_search($sock, $clients);
                if ($idx !== false) unset($clients[$idx]);
                socket_close($sock);
                echo "Client disconnected\n";
            } else {
                // 業務處理...
                socket_write($sock, "Echo: $data");
            }
        }
    }
}

最佳實踐提醒

  1. 錯誤處理:每次調用後檢查 socket_last_error(),區分 EAGAIN/EWOULDBLOCK(非阻塞無數據)與真實錯誤。
  2. 緩衝區管理:應用層實現發送隊列、接收拼包/分包(長度前綴/分隔符)。
  3. 信號處理:pcntl_signal(SIGTERM, ...) 優雅關閉所有 Socket。
  4. 現代替代:Swoole / OpenSwoole / RoadRunner / Workerman 提供協程化、事件驅動、多進程管理的高級封裝,生產環境強烈推薦遷移。

掌握原生 Socket API 有助於理解網絡編程本質,但在高併發業務中請優先選擇成熟框架,避免重複造輪子引入 Bug。

copyright © 萬盛學電腦網 all rights reserved