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/O | socket_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) | 關閉並釋放資源 |
$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");
}
}
}
}
socket_last_error(),區分 EAGAIN/EWOULDBLOCK(非阻塞無數據)與真實錯誤。pcntl_signal(SIGTERM, ...) 優雅關閉所有 Socket。掌握原生 Socket API 有助於理解網絡編程本質,但在高併發業務中請優先選擇成熟框架,避免重複造輪子引入 Bug。