## Swoole > Swoole是一個面向生產環境的 PHP 異步網絡通信引擎。使 PHP 開發人員可以編寫高性能的異步并發 TCP、UDP、Unix Socket、HTTP，WebSocket 服務。 ## 安裝 首先按照Swoole官網說明安裝`swoole`擴展，然后安裝`think-swoole`擴展。 ~~~ composer require topthink/think-swoole=2.0.* ~~~ >[danger] Swoole目前不支持Windows ## 使用 ### 使用`Swoole`作為`HttpServer` 命令行下啟動服務端（需要`2.0+`版本`think-swoole`擴展） 直接在命令行下啟動服務端。 ~~~ php think swoole ~~~ 啟動完成后，會在0.0.0.0:9501啟動一個HTTP Server，可以直接訪問當前的應用。 swoole的參數可以在應用配置目錄下的swoole.php里面配置（具體參考配置文件內容）。 如果需要使用守護進程方式運行，可以使用 ~~~ php think swoole -d ~~~ 或者在swoole.php文件中設置 ~~~ 'daemonize' => true ~~~ 注意：由于onWorkerStart運行的時候沒有HTTP_HOST，因此最好在應用配置文件中設置app_host 支持的操作包括 ~~~ php think swoole [start|stop|reload|restart] ~~~ > 由于`onWorkerStart`運行的時候沒有`HTTP_HOST`，因此最好在應用配置文件中設置`app_host`參數 啟動后，可以使用 ~~~ http://127.0.0.1:9501 ~~~ 訪問你的應用。 如果需要配置地址和端口，可以在應用配置目錄下增加 `swoole.php`配置文件，然后設置： ~~~ <?php return [ 'host' => 'tp5.com', 'port' => 9508, ]; ~~~ 可以支持`Swoole`自身的配置參數設置，例如： ~~~ <?php return [ 'host' => 'tp5.com', 'port' => 9508, 'worker_num' => 4, 'max_request' => 1000, ]; ~~~ 擴展中定義了`onWorkerStart`和`onRequest`事件回調方法（如果不熟悉請不要隨意替換），如果你需要自定義`swoole`的事件回調方法，可以在配置文件中使用閉包定義。 ~~~ <?php return [ 'host' => 'tp5.com', 'port' => 9508, 'worker_num' => 4, 'max_request' => 1000, 'WorkerStop' => function($server, $worker_id){ // 添加你的代碼 }, ]; ~~~ 或者直接在配置文件中添加 ### 使用`Swoole`作為`Server`服務端 可以支持直接啟動一個Swoole server（需要`2.0.9+`版本） ~~~ php think swoole:server ~~~ 會在0.0.0.0:9508啟動一個Websocket服務。 如果需要自定義參數，可以在config/swoole_server.php中進行配置，包括： 配置參數 | 描述 --- | --- type| 服務類型 host | 監聽地址 port | 監聽端口 mode | 運行模式 socket_type | Socket type 并且支持swoole所有的參數。 也支持使用閉包方式定義相關事件回調。 ~~~ return [ // 擴展自身配置 'host' => '0.0.0.0', // 監聽地址 'port' => 9501, // 監聽端口 'type' => 'socket', // 服務類型 支持 socket http server 'mode' => SWOOLE_PROCESS, 'socket_type' => SWOOLE_SOCK_TCP, // 可以支持swoole的所有配置參數 'daemonize' => false, // 事件回調定義 'onOpen' => function ($server, $request) { echo "server: handshake success with fd{$request->fd}\n"; }, 'onMessage' => function ($server, $frame) { echo "receive from {$frame->fd}:{$frame->data},opcode:{$frame->opcode},fin:{$frame->finish}\n"; $server->push($frame->fd, "this is server"); }, 'onRequest' => function ($request, $response) { $response->end("<h1>Hello Swoole. #" . rand(1000, 9999) . "</h1>"); }, 'onClose' => function ($ser, $fd) { echo "client {$fd} closed\n"; }, ]; ~~~ 也可以使用自定義的服務類 ~~~ <?php namespace app\http; use think\swoole\Server; class Swoole extends Server { protected $host = '127.0.0.1'; protected $port = 9502; protected $option = [ 'worker_num'=> 4, 'daemonize' => true, 'backlog' => 128 ]; public function onReceive($server, $fd, $from_id, $data) { $server->send($fd, 'Swoole: '.$data); } } ~~~ 支持swoole所有的回調方法定義（回調方法必須是public類型） serverType 屬性定義為 socket或者http 則支持swoole的swoole_websocket_server和swoole_http_server 然后在swoole_server.php中增加配置參數： ~~~ return [ 'swoole_class' => 'app\http\Swoole', ]; ~~~ 定義該參數后，其它配置參數均不再有效。 在命令行啟動服務端 ~~~ php think swoole:server ~~~ 支持reload|restart|stop|status 操作 ~~~ php think swoole:server reload ~~~