Swoole创建WebSocket服务的完整步骤与代码示例

编写WebSocket服务端脚本

新建一个名为 ws_server.php 的文件，其基本结构如下：

首先，实例化 SwooleWebSocketServer 对象，并绑定监听地址与端口。地址通常设为 "0.0.0.0"，端口可自定义，例如9501。

接下来，注册三个核心事件回调函数：

• open事件：当客户端完成HTTP握手后触发。此时可获取 $request->fd、$request->get、Cookie等数据，适合进行初始化操作。
• message事件：在收到客户端消息时触发。使用 $server->push($frame->fd, $data) 可向指定客户端发送响应；若需广播，可遍历 $server->connections 列表。
• close事件：连接关闭时触发，用于释放资源，防止因fd残留造成内存泄漏。

最后，调用 $server->start() 启动服务。至此，WebSocket服务端脚本的基本框架就搭建完成了。

开放端口与启动服务

启动服务有两种方式：

方法一：命令行直接运行
进入脚本目录，执行 php ws_server.php。服务将在后台持续运行，终端会输出启动日志，便于调试。

方法二：守护进程部署（生产环境推荐）
使用supervisor管理进程，设置 autostart=true 和 autorestart=true，确保服务意外退出后能自动重启。

【重要：防火墙必须放行9501（或你设定的端口），否则外部无法建立WebSocket连接】

不同环境下的端口放行方法：宝塔面板用户可在「安全」页面手动添加端口规则；CentOS系统执行 firewall-cmd --permanent --add-port=9501/tcp && firewall-cmd --reload。务必执行此步骤，否则前端无法连接。

前端连接测试验证

打开Chrome开发者工具的控制台，粘贴以下代码进行测试：

const ws = new WebSocket("ws://你的服务器IP:9501");

ws.onopen = () => console.log("已连接");

ws.onmessage = e => console.log("收到:", e.data);

ws.send("hello");

如果控制台显示“已连接”，同时服务端PHP进程输出“客户端 xxx 已连接”，则表示握手成功，WebSocket服务已正常运行。

这里有两个容易忽视的细节：第一，测试时不能使用 http:// 地址，必须使用 ws:// 协议；第二，本地测试可直接使用 ws://127.0.0.1:9501，避免防火墙配置的麻烦。