# 環境要求
## Windows用戶
Windows用戶只能使用windows版本的Workerman(```Workerman-for-win```)。
1、需要PHP>=5.3.3,并配置好PHP的環境變量。
2、Windows版本的Workerman不依賴任何擴展。
3、安裝使用以及注意事項參見[**這里**](http://www.workerman.net/windows)。
``` ====本頁面以下只適用于Linux用戶,Windows用戶請忽略。 ====```
## Linux用戶(含Mac OS)
Linux用戶只能使用Linux版本的Workerman。
1、安裝PHP>=5.3.3,并安裝了pcntl、posix擴展
2、建議安裝event或者libevent擴展,但不是必須的(注意event擴展需要PHP>=5.4)
### Linux環境檢查腳本
Linux用戶可以運行以下腳本檢查本地環境是否滿足WorkerMan要求
```curl -Ss <http://www.workerman.net/check.php> | php```
如果腳本中全部提示ok,則代表滿足WorkerMan運行環境
(注意:檢測腳本中沒有檢測event擴展或者libevent擴展,如果并發連接數大于1024建議安裝event擴展或者libevent擴展,安裝方法參見下一節)
## 詳細說明
### 關于PHP-CLI
WorkerMan是基于[PHP命令行(PHP-CLI)](http://php.net/manual/zh/features.commandline.php)模式運行的。PHP-CLI與PHP-FPM或者Apache的MOD-PHP是獨立的可執行程序,它們之間并不沖突也不會有相互依賴,完全獨立。
### 關于WorkerMan依賴的擴展
1、[pcntl擴展](http://cn2.php.net/manual/zh/book.pcntl.php)
pcntl擴展是PHP在Linux環境下進程控制的重要擴展,WorkerMan用到了其[進程創建](http://cn2.php.net/manual/zh/function.pcntl-fork.php)、[信號控制](http://cn2.php.net/manual/zh/function.pcntl-signal.php)、[定時器](http://cn2.php.net/manual/zh/function.pcntl-alarm.php)、[進程狀態監控](http://cn2.php.net/manual/zh/function.pcntl-waitpid.php)等特性。此擴展win平臺不支持。
2、[posix擴展](http://cn2.php.net/manual/zh/book.posix.php)
posix擴展使得PHP在Linux環境可以調用系統通過[POSIX標準](http://baike.baidu.com/view/209573.htm)提供的接口。WorkerMan主要使用了其相關的接口實現了守護進程化、用戶組控制等功能。此擴展win平臺不支持。
3、[libevent擴展](http://cn2.php.net/manual/en/book.libevent.php) 或者 [Event擴展](http://php.net/manual/zh/book.event.php)
libevent擴展(或者event擴展)使得PHP可以使用系統[Epoll](http://baike.baidu.com/view/1385104.htm)、Kqueue等高級事件處理機制,能夠顯著提高WorkerMan在高并發連接時CPU利用率。在高并發長連接相關應用中非常重要。libevent擴展(或者event擴展)不是必須的,如果沒安裝,則默認使用PHP原生Select事件處理機制。
## 如何安裝擴展
參見 [附錄-安裝擴展](315304) 章節
**備注**
* PHP>=5.4
* swoole-worker只依賴posix擴展和swoole擴展
* 不支持window操作系統,windows下可以使用CygWin,BashOnWindows,DockerOnWindows
詳見<https://wiki.swoole.com/wiki/page/7.html>
- 序言
- 原理
- 開發必讀
- 入門指引
- 特性
- 簡單的開發示例
- 安裝
- 環境要求
- 下載安裝
- 啟動停止
- 開發流程
- 開發前必讀
- 目錄結構
- 開發規范
- 基本流程
- 通訊協議
- 通訊協議作用
- 定制通訊協議
- 一些例子
- 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協議
- 不支持的函數/特性
- 版權信息