[TOC] [workerman相關手冊](https://www.workerman.net/doc) [workerman 手冊](https://www.workerman.net/doc/workerman/) [gateway-worker 手冊 (workerman.net)](https://www.workerman.net/doc/gateway-worker/) [webman 手冊 (workerman.net)](https://www.workerman.net/doc/webman/) ## **安裝前檢查(lnux)** ``` curl -Ss https://www.workerman.net/check | php ``` >[danger]檢查php版本大于5.4或者是否安裝pcntl擴展,posix擴展(兩擴展只在linux支持) 此外還建議安裝event擴展，但不是必須的(沒安裝，則默認使用PHP原生Select事件處理機制),能夠顯著提高WorkerMan在高并發連接時CPU利用率。在高并發長連接相關應用中非常重要 ## **Composer安裝：** ~~~sh composer require workerman/workerman ~~~ ## **啟動與停止** 注意Workerman啟動停止等命令都是在命令行中完成的。 要啟動Workerman，首先需要有一個啟動入口文件，里面定義了服務監聽的端口及協議。可以參考[入門指引--簡單開發實例部分](https://www.workerman.net/doc/workerman/getting-started/simple-example.html) 這里以[workerman-chat](https://www.workerman.net/workerman-chat)為例，它的啟動入口為start.php。 ### 啟動 以debug（調試）方式啟動 ``` php start.php start ``` 以daemon（守護進程）方式啟動 ``` php start.php start -d ``` ### 停止 ``` php start.php stop ``` ### 重啟 ``` php start.php restart ``` ### 平滑重啟 平滑重啟可以做到在不影響用戶的情況下重啟服務，以便重新載入PHP程序，完成業務代碼更新 ``` php start.php reload ``` ### 查看狀態 ``` php start.php status ``` ### 查看連接狀態（需要Workerman版本>=3.5.0） ``` php start.php connections ``` ## debug和daemon方式區別 * 1、以debug方式啟動，代碼中echo、var\_dump、print等打印函數會直接輸出在終端。 * 2、以daemon方式啟動，代碼中echo、var\_dump、print等打印會默認重定向到/dev/null文件，可以通過設置`Worker::$stdoutFile = '/your/path/file';`來設置這個文件路徑。 * 3、以debug方式啟動，終端(命令行窗口)關閉后workerman會隨之關閉并退出。 * 4、以daemon方式啟動，終端關閉后workerman繼續后臺正常運行。 ## **注意** * 使用require_once/include_once加載文件(WorkerMan會緩存編譯后的PHP文件不會主動釋放) * 開發者可以直接使用WorkerMan提供的[數據庫類](https://www.workerman.net/doc/workerman/components/workerman-mysql.html)，有斷開重連的功能(WorkerMan會緩存編譯后的PHP文件不即靜態成員不會被釋放,但是數據庫連接(一般是單例模式,且保存在靜態成員中)在一定時間內沒有操作會自動關閉) * 注意不要使用exit、die出語句 * 改完代碼需要重啟服務才能生效, * 初次鏈接必須在服務器放開端口(如確認服務器防火墻或安全組是否允許8181端口的入站連接)