1.5.2 下载安装
WorkerMan实际上就是一个PHP代码包,如果你的PHP环境已经装好,只需要把WorkerMan源代码或者demo下载下来即可运行。
Composer安装:
composer require workerman/workerman
Git安装:
git clone https://github.com/walkor/Workerman
windows用户(必读)
从workerman3.5.3版已经可以同时支持windows和linux系统。 windows用户需要配置下php环境变量。php环境变量设置参见这里。
===本页面以下仅适用于Linux环境workerman,windows用户请忽略===
Linux系统环境检测
Linux系统可以使用以下脚本测试本机PHP环境是否满足WorkerMan运行要求。 curl -Ss http://www.workerman.net/check.php | php
上面脚本如果全部显示ok,则代表满足WorkerMan要求,直接到官网下载例子即可运行。
如果不是全部ok,则参考下面文档安装缺失的扩展即可。
(注意:检测脚本中没有检测event扩展或者libevent扩展,如果业务并发连接数大于1024必须安装event扩展或者libevent扩展,并且优化Linux内核,扩展安装方法参照下面说明)
已有PHP环境安装缺失扩展
安装pcntl和posix扩展:
centos系统
如果php是通过yum安装的,则命令行运行 yum install php-process
即可安装pcntl和posix扩展。
如果安装失败或者php本身不是用yum安装的请参考手册附录-安装扩展一节中方法三源码编译安装。
debian/ubuntu/mac os系统
参考手册附录-安装扩展一节中方法三源码编译安装。
安装event或者libevent扩展:
为了能支持更大的并发连接数,必须安装event扩展或者libevent扩展(二者作用相同,二选一即可),并且优化Linux内核。以Event为例,安装方法如下:
centos系统
1、安装event扩展依赖的libevent-devel包,命令行运行
yum install libevent-devel -y
# php7 用下面命令
#yum install libevent2-devel -y
2、安装event扩展,命令行运行
(event扩展要求PHP>=5.4,PHP5.3用户请安装libevent扩展(libevent扩展同时支持php5.4-5.6),见本页面底部)
pecl install event
注意提示:Include libevent OpenSSL support [yes] :
时输入no
回车,
注意提示:PHP Namespace for all Event classes :
时输入yes
,其它直接敲回车就行
如果安装失败请参考页面底部常见问题或者跳过以下步骤尝试安装libevent扩展,见本页面底部。
3、命令行运行(如果ini文件位置不对,可以通过运行php --ini
找到实际加载的ini文件路径)
echo extension=event.so > /etc/php.d/30-event.ini
debian/ubuntu系统安装
1、安装event扩展依赖的libevent-dev包,命令行运行
apt-get install libevent-dev -y
# php7 用下面命令
apt-get install libevent2-dev -y
2、安装event扩展,命令行运行
(注意:event扩展要求PHP>=5.4,PHP5.3用户请安装libevent扩展(libevent扩展同时支持php5.4-5.6),见本页面底部)
pecl install event
注意提示:Include libevent OpenSSL support [yes] :
时输入no
回车,
注意提示:PHP Namespace for all Event classes :
时输入yes
,其它直接敲回车就行
如果安装失败请参考页面底部常见问题或者跳过以下步骤尝试安装libevent扩展,见本页面底部。
3、命令行运行(需要切换到root用户。如果ini文件位置不对,可以通过运行php --ini
找到实际加载的ini文件路径)
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程序)
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),见本页面底部)
pecl install event
注意提示:Include libevent OpenSSL support [yes] :
时输入no
回车,
注意提示:PHP Namespace for all Event classes :
时输入yes
,其它直接敲回车就行
如果安装失败请参考页面底部常见问题或者跳过以下步骤3,尝试安装libevent扩展,见本页面底部。
3、命令行运行(此步骤是配置event扩展的ini配置,如果ini文件位置不对,可以通过运行php --ini
找到实际加载的ini文件路径)
echo extension=event.so > /etc/php.d/30-event.ini
4、命令行运行(此步骤是通过github下载WorkerMan主程序)
git clone https://github.com/walkor/Workerman
5、参考入门指引--简单开发实例部分写入口文件运行。
或者从官网下载打包好的demo运行。
debian/ubuntu系统安装教程
1、命令行运行(此步骤包含了安装php-cli主程序、libevent库及git程序)
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),见本页面底部)
pecl install event
注意提示:Include libevent OpenSSL support [yes] :
时输入no
回车,
注意提示:PHP Namespace for all Event classes :
时输入yes
,其它直接敲回车就行
如果安装失败请参考页面底部常见问题或者跳过以下步骤3,尝试安装libevent扩展,见本页面底部。
3、命令行运行(需要切换到root用户。此步骤是配置Event扩展的ini配置,如果ini文件位置不对,可以通过运行php --ini
找到实际加载的ini文件路径)
echo extension=event.so > /etc/php5/cli/conf.d/30-event.ini
4、命令行运行(此步骤是通过github下载WorkerMan主程序)
git clone https://github.com/walkor/Workerman
5、参考入门指引--简单开发实例部分写入口文件运行。
或者从官网下载打包好的demo运行。
mac os 系统安装教程
方法1: mac系统自带PHP Cli,但是可能缺少pcntl
扩展。
1、参考手册附录-安装扩展一节中方法三源码编译安装pcntl
扩展。
2、参考手册附录-安装扩展一节中方法四利用phpize安装event
扩展(作为开发机此可省略)。
3、通过http://www.workerman.net/download/workermanzip 下载WorkerMan主程序,或者到官网下载例子运行。
方法2: 通过brew
命令安装php及对应扩展
1、命令行运行以下命令安装brew
工具(如果已经安装过brew
可以跳过此步骤)
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2、命令行运行以下命令安装php7
brew install php70
3、命令行运行以下命令安装event
扩展
brew install php70-event
4、到官网下载例子运行
Event扩展说明
Event扩展不是必须的,当业务需要支撑大于1000的并发连接时,推荐安装Event,能够支持巨大的并发连接。如果业务并发连接比较低,例如1000以下并发连接,则可以不用安装。
如果无法安装Event扩展,可以用libevent扩展代替,注意目前libevent扩展不支持php7,php7用户只能使用Event扩展。
安装libevent扩展方法如下:
注意: 1、libevent扩展也同样依赖libevent库,所以首先需要安装libevent-devel包(并非扩展)。 2、libevent扩展支持php5.3-5.6,目前还不支持php7。php7用户请使用event扩展,php7用户请不要装libevent扩展,否则会出现coredump错误。
centos系统
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系统
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文件路径
常见问题
1、如果出现如下报错 checking for include/event2/event.h... not found
,请先尝试删除libevent-dev(el)库安并装libevent2-dev(el)。 centos系统:yum remove libevent-devel && yum install libevent2-devel debian/ubuntu系统:apt-get remove libevent-dev && apt-get install libevent2-dev
2、如果出现如下报错NOTICE: PHP message: PHP Warning: PHP Startup: Unable to load dynamic library '.../event.so' - ..../event.so: undefined symbol: php_sockets_le_socket in Unknown on line 0
。 请更改event.so 和socket.so的加载顺序,既在php.ini中将 extension=socket.so
写在 extension=event.so
前面,让socket扩展先加载。