## Workerman > Workerman是一款純PHP開發的開源高性能的PHP socket 服務器框架。被廣泛的用于手機app、手游服務端、網絡游戲服務器、聊天室服務器、硬件通訊服務器、智能家居、車聯網、物聯網等領域的開發。 支持TCP長連接，支持Websocket、HTTP等協議，支持自定義協議。基于workerman開發者可以更專注于業務邏輯開發，不必再為PHP Socket底層開發而煩惱。 ## 安裝 首先通過 composer 安裝 ~~~ composer require topthink/think-worker ~~~ ## 使用 ### 使用`Workerman`作為`HttpServer` 在命令行啟動服務端 ~~~ php think worker ~~~ 然后就可以通過瀏覽器直接訪問當前應用 ~~~ http://localhost:2346 ~~~ linux下面可以支持下面指令 ~~~ php think worker [start|stop|reload|restart|status] ~~~ `workerman`的參數可以在應用配置目錄下的`worker.php`里面配置。 > 由于`onWorkerStart`運行的時候沒有`HTTP_HOST`，因此最好在應用配置文件中設置`app_host` ### SocketServer 在命令行啟動服務端（需要`2.0.5+`版本） ~~~ php think worker:server ~~~ 默認會在0.0.0.0:2345開啟一個`websocket`服務。 如果需要自定義參數，可以在`config/worker_server.php`中進行配置，包括： | 配置參數 | 描述 | | --- | --- | | protocol | 協議 | | host | 監聽地址 | | port | 監聽端口 | | socket | 完整的socket地址 | 并且支持`workerman`所有的參數（包括全局靜態參數）。 也支持使用閉包方式定義相關事件回調。 ~~~ return [ 'socket' => 'http://127.0.0.1:8000', 'name' => 'thinkphp', 'count' => 4, 'onMessage' => function($connection, $data) { $connection->send(json_encode($data)); }, ]; ~~~ 也支持使用自定義類作為`Worker`服務入口文件類。例如，我們可以創建一個服務類（必須要繼承 `think\worker\Server`），然后設置屬性和添加回調方法 ~~~ <?php namespace app\http; use think\worker\Server; class Worker extends Server { protected $socket = 'http://0.0.0.0:2346'; public function onMessage($connection,$data) { $connection->send(json_encode($data)); } } ~~~ 支持`workerman`所有的回調方法定義（回調方法必須是public類型） 然后在`worker_server.php`中增加配置參數： ~~~ return [ 'worker_class' => 'app\http\Worker', ]; ~~~ 定義該參數后，其它配置參數均不再有效。 在命令行啟動服務端 ~~~ php think worker:server ~~~ 然后在瀏覽器里面訪問 ~~~ http://localhost:2346 ~~~ 如果在Linux下面，同樣支持reload|restart|stop|status 操作 ~~~ php think worker:server reload ~~~ > 注意:使用默認worker做服務器時,`dump`會打印到命令行. ### 關于上傳文件 當按照默認的worker做http服務器時,并不能直接使用`request()->file('image')`來獲得上傳的文件,具體可以參考[workerman的上傳文件第6點](http://doc.workerman.net/web-server.html).因此只能迂回的使用`Filesystem`.無論怎樣,不影響其`getMime()`等方法的正確性. ``` // $file = request()->file('image'); $file_data = $_FILES[0]['file_data']; //$tmp_file = tempnam('','tm_'); 這種寫法最終保存時擴展名為.tmp $tmp_file = sys_get_temp_dir().'/'.uniqid().'.'.explode('/',$_FILES[0]['file_type'])[1]; file_put_contents($tmp_file,$file); $file = new File($tmp_file); $savename = Filesystem::putFile('upload',$file); echo $savename; ``` ### 自定義workerman指令 有時候我們希望使用think的命令行運行workerman,這里做一個介紹, 1:先新建一個指令,參考文檔:[自定義指令](http://www.hmoore.net/manual/thinkphp6_0/1037651),比如新建命令: ``` php think make:command Hello hello ``` 2:復制下面的代碼到指令里,覆蓋原始的`configure`和`execute`方法 ``` protected function configure() { // 指令配置 $this->setName('convert') ->addArgument('action', Argument::OPTIONAL, "start|stop|restart|reload|status|connections", 'start') ->addOption('mode', 'm', Option::VALUE_OPTIONAL, 'Run the workerman server in daemon mode.') ->setDescription('the workerman command'); } protected function execute(Input $input, Output $output) { // 指令輸出 $output->writeln('convert start'); $action = $input->getArgument('action'); $mode = $input->getOption('mode'); // 重新構造命令行參數,以便兼容workerman的命令 global $argv; $argv = []; array_unshift($argv, 'think', $action); if ($mode == 'd') { $argv[] = '-d'; } else if ($mode == 'g') { $argv[] = '-g'; } // 在這里放心的實例化worker, // 就像參照workerman文檔寫一樣, // 無非在workerman的文檔里,代碼是新建純php文件,但在這里,寫到了一個方法里. $worker_1 = new Worker(); $worker_2 = new Worker(); Worker::runAll(); } ``` 3:運行的時候,使用如下命令: ``` //臨時運行 php think hello start //后臺運行 php think hello start --mode d ```