# HelloSwoole
***
本文假設你已經有了 Linux 操作系統的 PHP 環境，并且符合上一篇文章的環境要求，強烈推薦使用 Vagrant 來搭建開發環境
除了可以按照文中搭建虛擬機或VPS安裝環境 外，也推薦你直接使用[新浪云](http://t.cn/RbsUCkH)來部署環境，更方便快捷，注冊賬號贈送的云豆足夠免費使用到學習完整本書的內容。
### 安裝 Swoole PECL 拓展
可以通過 pecl 命令或者通過源碼包編譯安裝，本文采用 pecl 命令來安裝 Swoole
在命令行輸入
~~~
$ > pecl install swoole
~~~
安裝 Swoole PECL 拓展，執行命令后通過`php -m`命令來檢查 Swoole 是否安裝成功，如果返回的拓展列表中包含`swoole`則表明已經安裝成功，也可以通過`phpinfo`來檢查 Swoole 是否安裝成功。
### 安裝 ThinkPHP5 框架
#### 1.安裝 Composer
如果已經安裝了 Composer 可以跳過本步驟，但是請確定通過`composer self-update`命令來確保已經使用了最新版本的 Composer
使用以下命令可以直接通過 Composer 官網下載 Composer.phar 并自動安裝到`/usr/local/bin/`目錄下
~~~
$ > php -r "readfile('https://getcomposer.org/installer');" | php -- --install-dir=/usr/local/bin/ --filename=composer
$ > composer self-update
~~~
如果以上安裝過程極慢的話，可以嘗試用以下方式通過 Composer 國內鏡像來安裝。
~~~
$ > php -r "readfile('http://install.phpcomposer.com/installer');" | php -- --install-dir=/usr/local/bin/ --filename=composer
$ > composer config -g repo.packagist composer https://packagist.phpcomposer.com
$ > composer self-update
~~~
#### 2.安裝 ThinkPHP5 框架
使用以下命令把最新版本的 ThinkPHP5 框架安裝到當前目錄下的 thinkSwooleFirst 文件夾中
~~~
$ > composer create-project topthink/think thinkSwooleFirst --prefer-dist
~~~
### 安裝 think-swoole Composer 包
把命令行目錄切換到 thinkSwooleFirst 目錄，通過 Composer 安裝 think-swoole
~~~
$ > composer require topthink/think-swoole
~~~
> 安裝 think-swoole Composer 包之前必須先安裝好 Swoole PECL 拓展
### HelloSwoole
當環境全部搭建完成后，我們在`application/index/controller`目錄下建立`Demon.php`文件，用來書寫 Swoole 與 ThinkPHP5 的 TCP 服務器的 Hello World
~~~
<?php
namespace app\index\controller;
// 必須 use 并繼承 \think\swoole\Server 類
use think\swoole\Server;
class Demon extends Server
{
// 監聽所有地址
protected $host = '0.0.0.0';
// 監聽 9501 端口
protected $port = 9501;
// 指定運行模式為多進程
protected $mode = SWOOLE_PROCESS;
// 指定 socket 的類型為 ipv4 的 tcp socket
protected $sockType = SWOOLE_SOCK_TCP;
// 配置項
protected $option = [
/**
* 設置啟動的worker進程數
* 業務代碼是全異步非阻塞的，這里設置為CPU的1-4倍最合理
* 業務代碼為同步阻塞，需要根據請求響應時間和系統負載來調整
*/
'worker_num' => 4,
// 守護進程化
'daemonize' => false,
// 監聽隊列的長度
'backlog' => 128
];
/**
* 收到信息時回調函數
* @param \swoole_server $server swoole_server對象
* @param $fd TCP客戶端連接的文件描述符
* @param $from_id TCP連接所在的Reactor線程ID
* @param $data 收到的數據內容
*/
public function onReceive(\swoole_server $server, $fd, $from_id, $data)
{
$server->send($fd, 'onReceive: ' . $data);
}
}
~~~
以上代碼即使用 ThinkPHP5 和 Swoole 完成了相對簡單的 TCP 服務器，接下來就可以運行服務器
使用以下命令即可啟動 TCP 服務器
~~~
$ > php public/index.php index/Demon/start
~~~
我們可以通過修改配置項`daemonize`為false，讓程序不使用守護進程，更方便我們的調試
如果配置項`daemonize`為true，也可以使用守護進程方式我們也可以使用`lsof`工具來檢測，端口是否處于正常狀態
~~~
$ > lsof -i:9501
~~~
當確認程序正常運行后，使用`telnet`工具來連接 TCP 服務器，稍后的文章中我們也會講述如果使用 swoole 的 TCP 客戶端來連接 TCP 服務器
~~~
telnet 127.0.0.1 9501
~~~
輸入`hello`后會得到以下結果
~~~
onReceive: hello
~~~