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 连接和消息
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事件，之后使用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）。
4. 注意事项
- 确保客户端使用正确的协议：
http://对应普通请求，ws://对应 WebSocket - 生产环境建议配合 Nginx 反向代理时，注意配置 WebSocket 支持（设置
Upgrade和Connection头） - 避免在
request回调中长时间阻塞，影响 WebSocket 实时性 - 可以结合路由判断，例如只允许特定路径进行 WebSocket 连接
