# websocket協議
# WebSocket協議
目前Workerman的WebSocke協議版本為13
WebSocket protocol 是HTML5一種新的協議。它實現了瀏覽器與服務器全雙工通信
## WebSocket與TCP關系
WebSocket和HTTP一樣是一種應用層協議,都是基于TCP傳輸的,WebSocket本身和Socket并沒有多大關系,更不能等同。
## WebSocket協議握手
WebSocket協議有一個握手的過程,握手時瀏覽器和服務端是以HTTP協議通信的,在Workerman中可以這樣介入到握手過程。
```php
...
$ws = new Worker('websocket://0.0.0.0:8181');
$ws->onConnect = function($connection)
{
$connection->onWebSocketConnect = function($connection , $http_header)
{
// 可以在這里判斷連接來源是否合法,不合法就關掉連接
// $_SERVER['HTTP_ORIGIN']標識來自哪個站點的頁面發起的websocket鏈接
if($_SERVER['HTTP_ORIGIN'] != 'http://chat.workerman.net')
{
$connection->close();
}
// onWebSocketConnect 里面$_GET $_SERVER是可用的
// var_dump($_GET, $_SERVER);
};
};
```
## WebSocket協議傳輸二進制數據
websocket協議默認只能傳輸utf8文本,如果要傳輸二進制數據,請閱讀以下部分。
websocket協議中在協議頭中使用一個標記位來標記傳輸的是二進制數據還是utf8文本數據,瀏覽器會驗證標記和傳輸的內容類型是否符合,如果不符合則會報錯斷開連接。
所以服務端發送數據的時候需要根據傳輸的數據類型設置這個標記位,在Workerman中如果是普通utf8文本,則需要設置(默認就是此值,一般不用再手動設置)
```php
use Workerman\Protocols\Websocket;
$connection->websocketType = Websocket::BINARY_TYPE_BLOB;
```
如果是二進制數據,則需要設置
```php
use Workerman\Protocols\Websocket;
$connection->websocketType = Websocket::BINARY_TYPE_ARRAYBUFFER;
```
**注意**:如果沒設置$connection->websocketType,則$connection->websocketType默認為BINARY\_TYPE\_BLOB(也就是utf8文本類型)。一般應用傳輸的都是utf8文本,例如傳輸的是json數據,所以不用手動設置$connection->websocketType。只有在傳輸二進制數據時(例如圖片數據、protobuffer數據等)才要設置此屬性為BINARY\_TYPE\_ARRAYBUFFER。
## 把workerman作為Websocket客戶端
可以利用[AsyncTcpConnection](/worker-development/__construct.html)配合[ws協議](/appendices/about-ws.html)讓workerman作為websocket客戶端連接遠程websocket服務端,完成雙向實時通訊。
- 序言
- 原理
- 開發必讀
- 入門指引
- 特性
- 簡單的開發示例
- 安裝
- 環境要求
- 下載安裝
- 啟動停止
- 開發流程
- 開發前必讀
- 目錄結構
- 開發規范
- 基本流程
- 通訊協議
- 通訊協議作用
- 定制通訊協議
- 一些例子
- Worker類
- 構造函數
- 屬性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回調屬性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection類
- 屬性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回調屬性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection類
- 構造函數
- connect
- reconnect
- transport
- Timer定時器類
- add
- del
- 定時器注意事項
- WebServer
- 調試
- 基本調試
- 查看運行狀態
- 網絡抓包
- 跟蹤系統調用
- 常用組件
- GlobalData數據共享組件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通訊組件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分組發送
- FileMonitor文件監控組件
- MySQL組件
- workerman/mysql
- swoole/mysql(異步)
- redis組件
- swoole/redis
- 異步http組件
- swoole/http-client
- 異步消息隊列組件
- react/zmq
- react/stomp
- 異步dns組件
- swoole/dns
- 常見問題
- 心跳
- 客戶端鏈接失敗原因
- 是否支持多線程
- 與其它框架整合
- 運行多個workerman
- 支持哪些協議
- 如何設置進程數
- 查看客戶端連接數
- 對象和資源的持久化
- 例子無法工作
- 啟動失敗
- 停止失敗
- 支持多少并發
- 更改代碼不生效
- 向指定客戶端發送數據
- 如何主動推送消息
- 在其它項目中推送
- 如何實現異步任務
- status里send_fail的原因
- Windows下開發Linux下部署
- 是否支持socket.io
- 終端關閉導致workerman關閉
- 與nginx apache的關系
- 禁用函數檢查
- 平滑重啟原理
- 為Flash開843端口
- 如何廣播數據
- 如何建立udp服務
- 監聽ipv6
- 關閉未認證的鏈接
- 傳輸加密-ssl/tsl
- 創建wss服務
- 創建https服務
- workerman作為客戶端
- 作為ws/wss客戶端
- PHP的幾種回調寫法
- 附錄
- Linux內核調優
- 壓力測試
- 安裝擴展
- websocket協議
- ws協議
- text協議
- frame協議
- 不支持的函數/特性
- 版權信息