在PHP环境中使用Swoole搭建WebSocket服务，需要依次完成扩展安装、服务端脚本编写、端口放行和进程启动四个关键步骤，缺一不可。每一步都紧密关联，若某步出错，整个服务将无法正常运行。下面将详细拆解每个环节的核心要点与常见陷阱，帮助你顺利搭建Swoole WebSocket服务器。
检查并安装Swoole扩展
首先，确认你的PHP环境是否已启用Swoole扩展。在终端运行 php -m | grep swoole，若无输出，则表示尚未安装。
推荐使用pecl一键安装：pecl install swoole。安装成功后，在php.ini文件中添加 extension=swoole，并重启PHP服务。注意：必须重启PHP服务，否则新扩展不会加载。
【重要：务必重启PHP服务，否则新扩展无法生效】
如何验证扩展安装成功？新建一个test.php文件，内容为 ，然后通过浏览器或命令行执行。若输出 bool(true)，则表示扩展加载成功，可以继续后续步骤。
编写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服务已正常运行。
这里有两个容易忽视的细节：第一，测试时不能使用 https:// 地址，必须使用 ws:// 协议；第二，本地测试可直接使用 ws://127.0.0.1:9501，避免防火墙配置的麻烦。
