Swoole如何在一个端口上同时处理HTTP和WebSocket-Swoole-PHP中文网

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

尼克

发布： 2025-10-12 16:42:02

原创

523人浏览过

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 可以在一个端口上同时处理 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. 示例代码：单端口处理两种协议

以下是一个完整的例子：

钉钉 AI 助理

钉钉AI助理汇集了钉钉AI产品能力，帮助企业迈入智能新时代。

查看详情

$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 事件，之后使用 message 和 push 进行双向通信

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）。