WebSocket 協議實現了瀏覽器與服務器的全雙工通信,極大擴展了 Web 應用的交互能力。在 PHP 生態中,Swoole 是構建高性能 WebSocket 服務的首選框架。本文提供一個基於 SwooleNetworkProtocolWebSocket 的完整服務端實現,包含連接管理、消息收發、廣播及日志記錄。
<?php
define('DEBUG', 'on');
define("WEBPATH", str_replace("\\", "/", __DIR__));
require __DIR__ . '/../libs/lib_config.php';
class WebSocket extends SwooleNetworkProtocolWebSocket {
/**
* 客戶端斷開連接時觸發
*/
function onClose($serv, $client_id, $from_id) {
// 可選:向所有人廣播下線通知
// $this->broadcast($client_id, "onOffline: " . $client_id);
parent::onClose($serv, $client_id, $from_id);
}
/**
* 收到客戶端消息時觸發
*/
function onMessage($client_id, $ws) {
$this->log("onMessage: " . $client_id . ' = ' . $ws['message']);
// 回覆發送者(回聲測試)
$this->send($client_id, "Server: " . $ws['message']);
// 可選:廣播給其他人
// $this->broadcast($client_id, $ws['message']);
}
/**
* 廣播消息給除發送者外的所有連接
*/
function broadcast($client_id, $msg) {
foreach ($this->connections as $clid => $info) {
if ($client_id != $clid) {
$this->send($clid, $msg);
}
}
}
}
// 啟動服務
$AppSvr = new WebSocket();
$AppSvr->loadSetting(__DIR__ . "/swoole.ini"); // 加載配置
$AppSvr->setLogger(new SwooleLogEchoLog(true)); // 控制台日志
$server = new SwooleNetworkServer('0.0.0.0', 9503);
$server->setProtocol($AppSvr);
// $server->daemonize(); // 生產環境建議開啟守護進程模式
$server->run(array('worker_num' => 4));
heartbeat_check_interval、heartbeat_idle_time 等心跳參數,防止僵死連接。const ws = new WebSocket('ws://your-server-ip:9503');
ws.onopen = () => console.log('連接成功');
ws.onmessage = (e) => console.log('收到:', e.data);
ws.send('Hello Swoole!');
ssl_cert_file、ssl_key_file 啟用 WSS 加密傳輸。heartbeat_check_interval=30、heartbeat_idle_time=60 自動清理斷開連接。{type: 'chat', payload: {...}}),便於擴展業務邏輯。Swoole 以 C 擴展形式實現了高性能網絡通信,配合面向對象的協議封裝,讓 PHP 開發者能輕鬆構建企業級 WebSocket 服務。掌握 onOpen、onMessage、onClose 三大生命周期鉤子,即可應對即時聊天、協同編輯、實時推送等多種場景。