GatewayWorker2.x 3.x 手冊

本手冊適用于GatewayWorker2.x版本以及3.x版本。

GatewayWorker 手冊

GatewayWorker基于Workerman開發(fā)的一個項目框架，用于快速開發(fā)TCP長連接應用，例如app推送服務端、即時IM服務端、游戲服務端、物聯(lián)網(wǎng)、智能家居等等

GatewayWorker使用經(jīng)典的Gateway和Worker進程模型。Gateway進程負責維持客戶端連接，并轉(zhuǎn)發(fā)客戶端的數(shù)據(jù)給BusinessWorker進程處理，BusinessWorker進程負責處理實際的業(yè)務邏輯（默認調(diào)用Events.php處理業(yè)務），并將結(jié)果推送給對應的客戶端。Gateway服務和BusinessWorker服務可以分開部署在不同的服務器上，實現(xiàn)分布式集群。

GatewayWorker提供非常方便的API，可以全局廣播數(shù)據(jù)、可以向某個群體廣播數(shù)據(jù)、也可以向某個特定客戶端推送數(shù)據(jù)。配合Workerman的定時器，也可以定時推送數(shù)據(jù)。

GatewayWorker 與 Workerman的關系

Workerman可以看做是一個純粹的socket類庫，可以開發(fā)幾乎所有的網(wǎng)絡應用，不管是TCP的還是UDP的，長連接的還是短連接的。Workerman代碼精簡，功能強大，使用靈活，能夠快速開發(fā)出各種網(wǎng)絡應用。同時Workerman相比GatewayWorker也更底層，需要開發(fā)者有一定的多進程編程經(jīng)驗。

因為絕大多數(shù)開發(fā)者的目標是基于Workerman開發(fā)TCP長連接應用，而長連接應用服務端有很多共同之處，例如它們有相同的進程模型以及單發(fā)、群發(fā)、廣播等接口需求。所以才有了GatewayWorker框架，GatewayWorker是基于Workerman開發(fā)的一個TCP長連接框架，實現(xiàn)了單發(fā)、群送、廣播等長連接必用的接口。GatewayWorker框架實現(xiàn)了Gateway Worker進程模型，天然支持分布式多服務器部署，擴容縮容非常方便，能夠應對海量并發(fā)連接?？梢哉fGatewayWorker是基于Workerman實現(xiàn)的一個更完善的專門用于實現(xiàn)TCP長連接的項目框架。

用GatewayWorker還是Workerman？

如果你的項目是長連接并且需要客戶端與客戶端之間通訊，建議使用GatewayWorker。
短連接或者不需要客戶端與客戶端之間通訊的項目建議使用Workerman。
GatewayWorker不支持UDP監(jiān)聽，所以UDP服務請選擇Workerman。
如果你是一個有多進程socket編程經(jīng)驗的人，喜歡定制自己的進程模型，可以選擇Workerman。

Linux系統(tǒng)快速開始（從一個精簡的聊天demo開始）

1、下載demo

2、命令行運行 unzip GatewayWorker.zip 解壓縮GatewayWorker.zip

3、命令行運行 cd GatewayWorker 進入GatewayWorker目錄

4、命令行運行 php start.php start 啟動GatewayWorker

5、新開幾個命令行窗口運行 telnet 127.0.0.1 8282，輸入任意字符即可聊天（非本機測試請將127.0.0.1替換成實際ip）。

注意
如果telnet超時請設置服務器安全組將8282端口開放。
如果需要測試websocket協(xié)議，需要將start_gateway.php中tcp改成websocket

Windows系統(tǒng)快速開始（從一個精簡的聊天demo開始）

1、下載demo

2、解壓到任意位置

3、進入GatewayWorker目錄

4、雙擊start_for_win.bat啟動。（如果出現(xiàn)錯誤請參考這里設置php環(huán)境變量）

5、新開幾個cmd命令行窗口運行 telnet 127.0.0.1 8282，輸入任意字符即可聊天（非本機測試請將127.0.0.1替換成實際ip，）。

注意
windows系統(tǒng)telnet可能需要安裝，安裝方法可以baidu下
windows系統(tǒng)telnet是逐字符發(fā)送的，可能無法發(fā)送完整的單詞語句
如果telnet超時請設置服務器安全組將8282端口開放
如果需要測試websocket協(xié)議，需要將start_gateway.php中tcp改成websocket

GatewayWorker 源碼地址

只包含GatewayWorker內(nèi)核
https://github.com/walkor/GatewayWorker