# swoole\_http\_client->upgrade [TOC] 发起WebSocket握手请求，并将连接升级为WebSocket。 ~~~ function swoole_http_client->upgrade(string $path, callable $callback); ~~~ * $path URL路径 * $callback 握手成功或失败后回调此函数 * 使用`Upgrade`方法必须设置`onMessage`回调函数 ## 使用实例 ~~~ $cli = new swoole_http_client('127.0.0.1', 9501); $cli->on('message', function ($_cli, $frame) { var_dump($frame); }); $cli->upgrade('/', function ($cli) { echo $cli->body; $cli->push("hello world"); }); ~~~ ## onMessage回调 ~~~ function onMessage(swoole_http_client $client, swoole_websocket_frame $frame); ~~~ * $client 客户端对象，可调用`push`方法向服务器发送数据 * $frame WebSocket数据帧，可参考[swoole\_websocket\_server->onMessage](https://wiki.swoole.com/wiki/page/402.html) ## 握手失败 某些`WebSocket`服务器对于客户端要求非常严格，`Client`需要非常接近`Chrome`等浏览器才可以握手成功。 可以通过增加参数和`Http`头，尽可能地让`Client`与`Chrome`等浏览器行为保持一致。 ~~~ $client->set([ 'websocket_mask' => true, 'ssl_host_name' => 'www.yourdomain.com', ]); $client->setHeaders([ 'Host' => 'www.yourdomain.com', 'UserAgent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.132 Safari/537.36' ]); ~~~ * `websocket_mask`启用数据掩码，浏览器总是对数据进行掩码处理，因为存在较多性能消耗，默认未开启 * `ssl_host_name`设置`openssl`域名，`SSL`握手时可能会验证此参数 * `Host`设置`Http`的`Host`头，某些服务器会验证此项信息