信息发布→ 登录 注册 退出

Swoole如何在一个端口上同时处理HTTP和WebSocket

发布时间:2025-10-12

点击量:
Swoole可通过单端口同时处理HTTP和WebSocket请求。1. 使用Swoole\Http\Server可自动识别协议类型:普通HTTP请求触发request事件,WebSocket握手请求(含Upgrade: websocket头)则触发open事件,后续通过message和close事件处理双向通信。2. 示例代码展示在9501端口监听,浏览器访问/health返回HTTP响应,WebSocket客户端连接时自动升级协议并进入长连接通信。3. Swoole底层自动判断请求类型,若需自定义校验可在request中检查upgrade头。4. 注意事项包括正确使用http://与ws://协议、Nginx代理时配置WebSocket支持、避免阻塞request回调及可按路径限制WebSocket接入。该机制无需额外端口或转发,实现简洁高效。

Swoole 可以在一个端口上同时处理 HTTP 和 WebSocket 请求,关键在于使用 混合协议监听 和正确的请求类型判断。Swoole 的 HttpServer 基于 Server 模块,支持在同一个端口根据客户端请求的协议类型自动区分是普通 HTTP 还是 WebSocket 握手请求。

1. 使用 Swoole\Http\Server 同时支持 HTTP 与 WebSocket

Swoole 的 HttpServer 内置了对 HTTP 和 WebSocket 的支持。当客户端发起 WebSocket 连接时,会先发送一个 HTTP 协议的握手请求(包含 Upgrade: websocket 头),Swoole 能自动识别并升级为 WebSocket 连接。

你只需要注册两个事件:

  • request:处理普通的 HTTP 请求
  • open / message / close:处理 WebSocket 连接和消息
只要 WebSocket 握手成功,后续通信就不再是 HTTP,而是基于帧的双向长连接。

2. 示例代码:单端口处理两种协议

以下是一个完整的例子:

$server = new Swoole\Http\Server("0.0.0.0", 9501);

// 处理普通 HTTP 请求
$server->on("request", function ($request, $response) {
    if ($request->server['request_uri'] === '/health') {
        $response->header("Content-Type", "text/plain");
        $response->end("OK\n");
    } else {
        $response->status(404);
        $response->end("Not Found\n");
    }
});

// WebSocket 握手成功时触发
$server->on('open', function ($server, $req) {
    echo "WebSocket client connected: {$req->fd}\n";
});

// 接收 WebSocket 消息
$server->on('message', function ($server, $frame) {
    echo "Received message: {$frame->data} from {$frame->fd}\n";
    $server->push($frame->fd, "You said: {$frame->data}");
});

// WebSocket 连接关闭
$server->on('close', function ($server, $fd) {
    echo "Client {$fd} disconnected\n";
});

$server->start();

在这个例子中,所有请求都走 9501 端口:

  • 浏览器访问 http://your-server:9501/health → 触发 request 事件,返回 HTTP 响应
  • WebSocket 客户端连接 ws://your-server:9501 → 先触发 request(握手阶段),然后进入 open 事件,之后使用 messagepush 进行双向通信

3. 如何区分 HTTP 与 WebSocket 请求?

Swoole 在底层自动判断:

  • 如果请求头包含 Upgrade: websocket,且是合法握手请求,Swoole 自动升级为 WebSocket 连接,并触发 open 事件
  • 否则,作为普通 HTTP 请求交给 request 回调处理

你也可以在 request 中手动判断是否为 WebSocket 握手:

$server->on("request", function ($request, $response) {
    if (isset($request->header['upgrade']) && strtolower($request->header['upgrade']) == 'websocket') {
        // 这是 WebSocket 握手,通常不在此处拦截,让 Swoole 自动处理即可
        // 正常情况下无需手动响应,Swoole 会自动完成握手
    } else {
        // 普通 HTTP 请求
        $response->end("Hello HTTP");
    }
});
一般不需要手动处理握手,Swoole 会自动完成,除非你需要自定义校验逻辑(如检查 Origin 或 Token)。

4. 注意事项

  • 确保客户端使用正确的协议:http:// 对应普通请求,ws:// 对应 WebSocket
  • 生产环境建议配合 Nginx 反向代理时,注意配置 WebSocket 支持(设置 UpgradeConnection 头)
  • 避免在 request 回调中长时间阻塞,影响 WebSocket 实时性
  • 可以结合路由判断,例如只允许特定路径进行 WebSocket 连接
基本上就这些。Swoole 的设计使得单端口同时服务 HTTP 和 WebSocket 非常自然,不需要额外端口或复杂转发。
标签:# 客户端  # 在这个  # 这是  # 是一个  # 自动完成  # 升级为  # 自定义  # 自动识别  # 不需要  # 回调  # nginx  # http  # 事件  # Token  # swoole  # 路由  # ai  # websocket  # 端口  # 浏览器  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!