Swoole如何处理WebSocket的握手过程

Swoole自动处理WebSocket握手，解析Sec-WebSocket-Key等字段并生成Sec-WebSocket-Accept响应，通过onHandShake可自定义验证，成功后触发onOpen事件建立长连接。

Swoole处理WebSocket握手的过程是自动完成的，但开发者需要理解其底层机制以便正确配置和扩展功能。当客户端发起WebSocket连接请求时，Swoole会拦截HTTP升级请求（Upgrade: websocket），并按照WebSocket协议规范完成握手流程。

1. 握手请求的接收与解析

Swoole内置了对HTTP Upgrade头的支持，在收到客户端的WebSocket连接请求时，会自动解析以下关键字段：

• Sec-WebSocket-Key：客户端随机生成的Base64编码字符串
• Sec-WebSocket-Version：指示WebSocket协议版本（通常为13）
• Connection 和 Upgrade 头是否包含"Upgrade"和"websocket"

如果这些字段缺失或不合法，Swoole会直接拒绝连接，不会触发onOpen事件。

2. 自动响应握手协议

Swoole根据RFC6455标准自动生成正确的握手响应：

立即进入“豆包AI人工智官网入口”；

立即学习“豆包AI人工智能在线问答入口”；

• 将客户端的Sec-WebSocket-Key与固定字符串258EAFA5-E914-47DA-95CA-C5AB0DC85B11拼接
• 对该字符串进行SHA-1哈希并Base64编码，生成Sec-WebSocket-Accept
• 返回状态码101 Switching Protocols，并带上必要的响应头

整个过程无需手动实现，Swoole在底层已完成加密计算和响应构造。

3. 在onHandShake中自定义验证

虽然握手由Swoole自动处理，但可以通过监听onHandShake事件插入自定义逻辑：

豆包AI编程

豆包推出的AI编程助手

483

查看详情

$server->on('handshake', function($request, $response) {
    // 验证来源域名
    if (!isset($request->header['sec-websocket-protocol'])) {
        $response->end();
        return false;
    }
    
    // 设置Cookie或其他头部（可选）
    $response->cookie("ws_connected", "1");

    // 必须调用accept()才能继续握手
    $response->end();
});

在这个阶段可以做身份校验、跨域控制或记录日志。若拒绝连接，调用$response->end()即可中断流程。

4. 成功后触发onOpen事件

一旦握手成功，Swoole会立即触发onOpen回调，表示WebSocket连接已建立：

$server->on('open', function($server, $req) {
    echo "WebSocket连接建立，FD: {$req->fd}\n";
});

此后该连接进入长会话状态，可通过$server->push()发送数据，后续通信不再经过HTTP流程。

基本上就这些。Swoole把WebSocket握手的复杂性封装得很好，开发者只需关注业务层面的连接管理与消息处理即可。不复杂但容易忽略的是onHandShake这个钩子，它给了你在正式通信前做安全检查的机会。

以上就是Swoole如何处理WebSocket的握手过程的详细内容，更多请关注php中文网其它相关文章！