Workerman如何在WebSocket响应中添加Header

最近在用 Workerman 学习 WebSocket 的时候，遇到了一个问题：

var ws = new WebSocket('ws://' + document.domain + ':8081', 'encrypt');

结果浏览器报了这个错：

Error during WebSocket handshake: Sent non-empty ‘Sec-WebSocket-Protocol’ header but no response was receive

查阅了 RFC文档 得知问题在于新建WebSocket时的第二个参数，表示客户端接受的子协议。

子协议是什么？比如浏览器向服务端发起两个WebSocket连接，一条连接使用明文传输数据，另一条使用加密传输数据。

服务端可以开启两个端口分别处理明文和加密连接。也可以只开一个端口，通过客户端提供的子协议来判断该连接传输数据的方式。

那么新建WebSocket时的子协议参数，最终是以什么形式发送到服务端的？就藏在请求Header的 Sec-Websocket-Protocol 中：

服务端接收到 Sec-Websocket-Protocol 后，必须在响应 Header 中也包含 Sec-Websocket-Protocol，取值和客户端传来的一样。否则浏览器就会报错：Error during WebSocket handshake: Sent non-empty ‘Sec-WebSocket-Protocol’ header but no response was receive

再提一点，子协议参数可以是个数组，比如：

var ws = new WebSocket('ws://' + document.domain + ':8081', ['text', 'json']);

表示该WebSocket连接既接收字符格式的数据，也可以接收JSON格式的数据，这时服务端必须在两者中选择其一返回给浏览器。

有点扯远了，今天的主角是 Workerman。Workerman 要获得子协议参数，需要在 onConnect 回调中设置 onWebSocketConnect 回调：

$ws = new Worker('websocket://0.0.0.0:8081');
$ws->onConnect = function (TcpConnection $connection) {
    $connection->onWebSocketConnect = function (TcpConnection $connection, $header) {
        if (isset($_SERVER['HTTP_SEC_WEBSOCKET_PROTOCOL'])) {
            $protocols = explode(',', $_SERVER['HTTP_SEC_WEBSOCKET_PROTOCOL']);
            $connection->headers = [
                'Sec-WebSocket-Protocol: ' . $protocols[0],
            ];
        }
    };
};

然后通过 $_SERVER['HTTP_SEC_WEBSOCKET_PROTOCOL'] 获得浏览器发来的子协议参数，是个字符串。如果浏览器接受多个子协议，那么协议之间会以 逗号 分隔。方便起见，例子中总是返回第一种子协议。

服务端响应时，将 Sec-Websocket-Protocol 字段放入 $connection->headers 数组中，这样就完成了子协议的协商。