# 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
~~~