萬盛學電腦網

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

基於 Swoole 擴展實現 PHP WebSocket 服務端完整示例

前言

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));

關鍵配置說明

  • worker_num:Worker 進程數,建議設置為 CPU 核心數的 1-4 倍。
  • swoole.ini:可配置 heartbeat_check_interval、heartbeat_idle_time 等心跳參數,防止僵死連接。
  • daemonize:生產環境務必開啟守護進程模式,脫離終端運行。

前端測試代碼片段

const ws = new WebSocket('ws://your-server-ip:9503');
ws.onopen = () => console.log('連接成功');
ws.onmessage = (e) => console.log('收到:', e.data);
ws.send('Hello Swoole!');

生產環境優化建議

  1. SSL/TLS:配置 ssl_cert_file、ssl_key_file 啟用 WSS 加密傳輸。
  2. 心跳檢測:設置 heartbeat_check_interval=30、heartbeat_idle_time=60 自動清理斷開連接。
  3. 消息協議:定義 JSON 協議格式(如 {type: 'chat', payload: {...}}),便於擴展業務邏輯。
  4. 監控指標:接入 Prometheus/Grafana 監控連接數、消息吞吐、內存佔用。

總結

Swoole 以 C 擴展形式實現了高性能網絡通信,配合面向對象的協議封裝,讓 PHP 開發者能輕鬆構建企業級 WebSocket 服務。掌握 onOpen、onMessage、onClose 三大生命周期鉤子,即可應對即時聊天、協同編輯、實時推送等多種場景。

WebSocket 架構圖
copyright © 萬盛學電腦網 all rights reserved