# swoole 安装

* 安装方式
  * 编译安装方式
  * pecl安装方式
* 配置php.ini
* 快速查看当前swoole的版本
* 升级swoole版本

## 编译方式安装:

```
$ wget http://pecl.php.net/get/swoole-2.2.0.tgz
$ tar -zxvf swoole-2.2.0.tgz
$ cd swoole-2.2.0/
$ phpize
$ ./configure
$ make && make install
```

注意swoole的`./configure`有很多额外参数，可以通过命令`./configure --help`查看,这里均选择默认项),可以参考官方的文档:[编译参数](https://wiki.swoole.com/wiki/page/437.html)

> ./configure \\
>
> \--enable-coroutine \\
>
> \--enable-async-redis \\
>
> make clean && make && sudo make install

编译安装的常见错误参看[官方链接](https://wiki.swoole.com/wiki/page/438.html)

## PECL方式安装:

```
$ pecl install swoole
```

安装指定的版本:

```
$ pecl install swoole-2.1.1
```

资料

[PECL 扩展库安装](https://www.php.net/manual/zh/install.pecl.php)

[swoole -pecl的地址](http://pecl.php.net/package/swoole)

## 配置php.ini

编译安装成功后，修改`php.ini`加入

```
extension=swoole.so
```

通过`php -m`或`phpinfo()`来查看是否成功加载了`swoole.so`，如果没有可能是`php.ini`的路径不对，可以使用`php --ini`来定位到`php.ini`的绝对路径。

针对swoole的一些php.ini配置,请参考官方文档[php.ini选项](https://wiki.swoole.com/wiki/page/352.html)

## 快速查看当前swoole的版本

```
php --ri swoole
```

## 升级swoole版本

**源码编译升级**

直接从github/pecl下载一个新版本，重新安装编译。

* 更新swoole版本，不需要卸载或者删除旧版本swoole，安装过程会覆盖旧版本
* swoole编译安装后没有额外的文件，仅有一个swoole.so，如果是在其他机器编译好的二进制版本。直接互相覆盖swoole.so，即可实现版本切换
* git clone拉取的代码，执行git pull更新代码后，务必要再次执行`phpize、./configure、make clean、make && make install`

**pecl一键升级**

```
pecl upgrade swoole
```

## 资料

[swoole官方文档-编译安装](https://wiki.swoole.com/wiki/page/6.html)

[swoole官方文档-常见错误](https://wiki.swoole.com/wiki/page/438.html)

> 版本类型
>
> * alpha 特性预览版本，表示开发计划中的任务已完成，进行开放预览，可能会存在较多BUG
> * beta 测试版本，表示已经可以用于开发环境测试，可能存在BUG
> * rc\[1-n] 候选发布版本，表示进入发布周期，正在做大范围的测试，在此期间仍可能发现BUG
> * stable 稳定版，表示此版本已完毕，可正式投入使用
>
> 单双数版本
>
> * 单数版本为特性新增版本，主要工作是新增功能特性、代码重构、结构调整。可能会带来一些BUG。
> * 双数版本为问题修复版本，主要工作是修复现有的已知问题、提升性能、完善细节。稳定性更高