# swoole_http_client->upgrade 發起WebSocket握手請求，并將連接升級為WebSocket。 ```php function swoole_http_client->upgrade(string $path, callable $callback); ``` * $path URL路徑 * $callback 握手成功或失敗后回調此函數 * 使用`Upgrade`方法必須設置`onMessage`回調函數 使用實例 -------- ```php $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回調 ------ ```php 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`等瀏覽器行為保持一致。 ```php $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`頭，某些服務器會驗證此項信息