# 安装说明
WorkerMan实际上就是一个PHP代码包，如果你的PHP环境已经装好，只需要把WorkerMan源代码或者demo下载下来即可运行。
# windows用户（必读）
windows用户需要使用windows版本的workerman，windows版本workerman本身**不依赖任何扩展**，只需要配置好PHP环境变量即可，**windows版本workerman安装及注意事项参见[windows用户必看](http://www.workerman.net/windows)。**
`===本页面以下仅适用于Linux版本workerman，windows用户请忽略===`
# Linux系统环境检测
Linux系统可以使用以下脚本测试本机PHP环境是否满足WorkerMan运行要求。
```curl -Ss <http://www.workerman.net/check.php> | php```
上面脚本如果全部显示ok，则代表满足WorkerMan要求，直接到[官网](http://www.workerman.net/)下载例子即可运行。
如果不是全部ok，则参考下面文档安装缺失的扩展即可。
（注意：检测脚本中没有检测event扩展或者libevent扩展，如果业务并发连接数大于1024建议安装event扩展或者libevent扩展，安装方法参照下面说明）
# 已有PHP环境安装缺失扩展
## 安装pcntl和posix扩展：
**centos系统**
如果php是通过yum安装的，则命令行运行 ```yum install php-process```即可安装pcntl和posix扩展。
如果安装失败或者php本身不是用yum安装的请参考手册[附录-安装扩展](315304)一节中方法三源码编译安装。
**debian/ubuntu/mac os系统**
参考手册[附录-安装扩展](315304)一节中方法三源码编译安装。
## 安装event或者libevent扩展：
为了能支持更大的并发连接数，建议安装event扩展或者libevent扩展(二者作用相同，二选一即可)。以Event为例，安装方法如下:
**centos系统安装**
1、安装event扩展依赖的libevent-devel包，命令行运行
```php
yum install libevent-devel -y
```
2、安装event扩展，命令行运行
(event扩展要求PHP>=5.4，PHP5.3用户请安装libevent扩展(libevent扩展同时支持php5.4-5.6)，见本页面底部)
```php
pecl install event
```
注意提示：```Include libevent OpenSSL support \[yes\] :``` 时输入```no```回车，其它直接敲回车就行
如果安装失败请跳过以下步骤，尝试安装libevent扩展，见本页面底部。
3、命令行运行（如果ini文件位置不对，可以通过运行```php --ini```找到实际加载的ini文件路径）
```php
echo extension=event.so > /etc/php.d/30-event.ini
```
**debian/ubuntu系统安装**
1、安装event扩展依赖的libevent-dev包，命令行运行
```php
apt-get install libevent-dev -y
```
2、安装event扩展，命令行运行
(注意：event扩展要求PHP>=5.4，PHP5.3用户请安装libevent扩展(libevent扩展同时支持php5.4-5.6)，见本页面底部)
```php
pecl install event
```
注意提示：```Include libevent OpenSSL support \[yes\] :``` 时输入```no```回车，其它直接敲回车就行
如果安装失败请跳过以下步骤，尝试安装libevent扩展，见本页面底部。
3、命令行运行(需要切换到root用户。如果ini文件位置不对，可以通过运行```php --ini```找到实际加载的ini文件路径)
```php
echo extension=event.so > /etc/php5/cli/conf.d/30-event.ini
```
### mac os 系统安装教程
mac 系统一般作为开发机，不必安装event扩展。
## 全新系统安装（全新安装PHP+扩展）
### centos系统安装教程
1、命令行运行（此步骤包含了安装php-cli主程序以及pcntl、posix、libevent库及git程序）
```php
yum install php-cli php-process git gcc php-devel php-pear libevent-devel -y
```
2、安装event扩展，命令行运行
(注意：event扩展要求PHP>=5.4，PHP5.3用户请安装libevent扩展(libevent扩展也支持php5.4-5.6)，见本页面底部)
```php
pecl install event
```
注意提示：```Include libevent OpenSSL support \[yes\] :``` 时输入```no```回车，其它直接敲回车就行
如果安装失败请跳过以下步骤3，尝试安装libevent扩展，见本页面底部。
3、命令行运行（此步骤是配置event扩展的ini配置，如果ini文件位置不对，可以通过运行```php --ini```找到实际加载的ini文件路径）
```php
echo extension=event.so > /etc/php.d/30-event.ini
```
4、命令行运行（此步骤是通过github下载WorkerMan主程序）
```php
git clone https://github.com/walkor/Workerman
```
5、参考[入门指引--简单开发实例部分](315113)写入口文件运行。
或者从[官网](http://www.workerman.net/)下载打包好的demo运行。
### debian/ubuntu系统安装教程
1、命令行运行（此步骤包含了安装php-cli主程序、libevent库及git程序）
```php
apt-get install php5-cli git gcc php-pear php5-dev libevent-dev -y
```
2、安装event扩展，命令行运行
(注意：event扩展要求PHP>=5.4，PHP5.3用户请安装libevent扩展(libevent扩展也支持php5.4-5.6)，见本页面底部)
```php
pecl install event
```
注意提示：```Include libevent OpenSSL support \[yes\] :``` 时输入```no```回车，其它直接敲回车就行
如果安装失败请跳过以下步骤3，尝试安装libevent扩展，见本页面底部。
3、命令行运行（需要切换到root用户。此步骤是配置Event扩展的ini配置，如果ini文件位置不对，可以通过运行```php --ini```找到实际加载的ini文件路径）
```php
echo extension=event.so > /etc/php5/cli/conf.d/30-event.ini
```
4、命令行运行（此步骤是通过github下载WorkerMan主程序）
```php
git clone https://github.com/walkor/Workerman
```
5、参考[入门指引--简单开发实例部分](315113)写入口文件运行。
或者从[官网](http://www.workerman.net/)下载打包好的demo运行。
### mac os 系统安装教程
**方法1：**mac系统自带PHP Cli，但是可能缺少```pcntl```扩展。
1、参考手册[附录-安装扩展](315304)一节中方法三源码编译安装```pcntl```扩展。
2、参考手册[附录-安装扩展](315304)一节中方法四利用phpize安装```event```扩展（作为开发机此可省略）。
3、通过<http://www.workerman.net/download/workermanzip> 下载WorkerMan主程序，或者到[官网](http://www.workerman.net/)下载例子运行。
**方法2：**通过```brew```命令安装php及对应扩展
1、命令行运行以下命令安装```brew```工具(如果已经安装过```brew```可以跳过此步骤)
```php
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
2、命令行运行以下命令安装```php7```
```php
brew install php70
```
3、命令行运行以下命令安装```event```扩展
```php
brew install php70-event
```
4、到[官网](http://www.workerman.net/)下载例子运行
## Event扩展说明
[Event扩展](http://php.net/manual/zh/book.event.php)不是必须的，当业务需要支撑大于1000的并发连接时，推荐安装Event，能够支持巨大的并发连接。如果业务并发连接比较低，例如1000以下并发连接，则可以不用安装。
如果无法安装[Event扩展](http://php.net/manual/zh/book.event.php)，可以用[libevent扩展](http://php.net/manual/zh/book.libevent.php)代替，注意目前libevent扩展不支持php7，php7用户只能使用Event扩展。
### 安装libevnet扩展方法如下：
**注意：**
1、libevnet扩展也同样依赖libevent库，所以首先需要安装libevent-devel包(并非扩展)。
2、libevent扩展支持php5.3-5.6，目前还不支持php7。php7用户请使用event扩展，php7用户请不要装libevent扩展，否则会出现coredump错误。
**centos系统**
```php
yum install libevent-devel
pecl install channel://pecl.php.net/libevent-0.1.0 //提示libevent installation [autodetect]: 时按回车
echo extension=libevent.so > /etc/php.d/libevent.ini
```
如果ini文件位置不对，可以通过运行 ```php --ini``` 找到实际加载的ini文件路径
**debian/ubuntu系统**
```php
apt-get install libevent-dev
pecl install channel://pecl.php.net/libevent-0.1.0 //提示libevent installation [autodetect]: 时按回车
echo extension=libevent.so > /etc/php5/cli/conf.d/libevent.ini
```
如果ini文件位置不对，可以通过运行 ```php --ini``` 找到实际加载的ini文件路径
- 序言
- 原理
- 开发必读
- 入门指引
- 特性
- 简单的开发示例
- 安装
- 环境要求
- 下载安装
- 启动停止
- 开发流程
- 开发前必读
- 目录结构
- 开发规范
- 基本流程
- 通讯协议
- 通讯协议作用
- 定制通讯协议
- 一些例子
- Worker类
- 构造函数
- 属性
- id
- count
- name
- protocol
- transport
- reusePort
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回调属性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- runAll
- stopAll
- listen
- TcpConnection类
- 属性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- maxPackageSize
- 回调属性
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 接口
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- AsyncTcpConnection类
- 构造函数
- connect
- reconnect
- transport
- Timer定时器类
- add
- del
- 定时器注意事项
- WebServer
- 调试
- 基本调试
- 查看运行状态
- 网络抓包
- 跟踪系统调用
- 常用组件
- GlobalData数据共享组件
- GlobalDataServer
- GlobalDataClient
- Channel分布式通讯组件
- ChannelServer
- channelClient
- 例子-集群推送
- 例子-分组发送
- FileMonitor文件监控组件
- MySQL组件
- workerman/mysql
- swoole/mysql(异步)
- redis组件
- swoole/redis
- 异步http组件
- swoole/http-client
- 异步消息队列组件
- react/zmq
- react/stomp
- 异步dns组件
- swoole/dns
- 常见问题
- 心跳
- 客户端链接失败原因
- 是否支持多线程
- 与其它框架整合
- 运行多个workerman
- 支持哪些协议
- 如何设置进程数
- 查看客户端连接数
- 对象和资源的持久化
- 例子无法工作
- 启动失败
- 停止失败
- 支持多少并发
- 更改代码不生效
- 向指定客户端发送数据
- 如何主动推送消息
- 在其它项目中推送
- 如何实现异步任务
- status里send_fail的原因
- Windows下开发Linux下部署
- 是否支持socket.io
- 终端关闭导致workerman关闭
- 与nginx apache的关系
- 禁用函数检查
- 平滑重启原理
- 为Flash开843端口
- 如何广播数据
- 如何建立udp服务
- 监听ipv6
- 关闭未认证的链接
- 传输加密-ssl/tsl
- 创建wss服务
- 创建https服务
- workerman作为客户端
- 作为ws/wss客户端
- PHP的几种回调写法
- 附录
- Linux内核调优
- 压力测试
- 安装扩展
- websocket协议
- ws协议
- text协议
- frame协议
- 不支持的函数/特性
- 版权信息