安装说明
Workerman 实际上就是一个 PHP 代码包,如果你的 PHP 环境已经装好,只需要把 Workerman 源代码或者 demo 下载下来即可运行。
Composer 安装:
composer require workerman/workerman
注意 有些 composer 代理镜像不全,使用以上命令
composer config -g --unset repos.packagist
移除代理
windows 用户(必读)
从 workerman3.5.3 版开始 workerman 已经可以同时支持 windows 和 linux 系统。 windows 用户需要配置下 php 环境变量。
===本页面以下仅适用于Linux环境workerman,windows用户请忽略===
Linux 系统环境检测
Linux 系统可以使用以下脚本测试本机 PHP 环境是否满足 Workerman 运行要求。 curl -Ss https://www.workerman.net/check | php
上面脚本如果全部显示 ok,则代表满足 Workerman 要求,直接到官网下载例子即可运行。
如果不是全部 ok,则参考下面文档安装缺失的扩展即可。
(注意:检测脚本中没有检测 event 扩展,如果业务并发连接数大于 1024 必须安装 event 扩展,并且优化 Linux 内核,扩展安装方法参照下面说明)
已有 PHP 环境安装缺失扩展
安装 pcntl 和 posix 扩展:
centos 系统 如果 php 是通过 yum 安装的,则命令行运行 yum install php-process
即可安装 pcntl 和 posix 扩展。
如果安装失败或者 php 本身不是用 yum 安装的请参考手册附录 - 安装扩展一节中方法三源码编译安装。
debian/ubuntu/mac os 系统 参考手册附录 - 安装扩展一节中方法三源码编译安装。
安装 event 扩展:
为了能支持更大的并发连接数,必须安装 event 扩展,并且优化 Linux 内核。安装方法如下:
centos 系统
1、安装 event 扩展依赖的 libevent-devel 包,命令行运行
yum install libevent-devel -y
# 如果无法安装,尝试使用下面的命令
# yum install libevent2-devel -y
2、安装 event 扩展,命令行运行 (event 扩展要求 PHP>=5.4)
pecl install event
注意提示: Include libevent OpenSSL support [yes] :
时输入 no
回车,其它直接敲回车就行
3、运行 php --ini
找到并打开 php.ini 文件,在最后一行加入如下配置
extension=event.so
debian/ubuntu 系统安装
1、安装 event 扩展依赖的 libevent-dev 包,命令行运行
apt-get install libevent-dev -y
# 如果无法安装,请尝试以下命令
# apt-get install libevent2-dev -y
2、安装 event 扩展,命令行运行
pecl install event
注意提示: Include libevent OpenSSL support [yes] :
时输入 no
回车,其它直接敲回车就行
3、运行 php --ini
找到并打开 php.ini 文件,在最后一行加入如下配置
extension=event.so
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)
pecl install event
注意提示: Include libevent OpenSSL support [yes] :
时输入 no
回车,其它直接敲回车就行
3、运行 php --ini
找到并打开 php.ini 文件,在最后一行加入如下配置
extension=event.so
4、命令行运行(此步骤是通过 github 下载 Workerman 主程序)
git clone https://github.com/walkor/Workerman
5、参考入门指引 -- 简单开发实例部分写入口文件运行。 或者从官网下载打包好的 demo 运行。
debian/ubuntu 系统安装教程
1、命令行运行(此步骤包含了安装 php-cli 主程序、libevent 库及 git 程序)
apt-get install php-cli git gcc php-pear php-dev libevent-dev -y
2、安装 event 扩展,命令行运行 (注意:event 扩展要求 PHP>=5.4)
pecl install event
注意提示: Include libevent OpenSSL support [yes] :
时输入 no
回车,其它直接敲回车就行
3、运行 php --ini
找到并打开 php.ini 文件,在最后一行加入如下配置
extension=event.so
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、通过 https://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、命令行运行以下命令安装 php
brew install php
3、命令行运行以下命令安装 event
扩展
brew install php-event
4、到官网下载例子运行
Event 扩展说明
Event 扩展不是必须的,当业务需要支撑大于 1000 的并发连接时,推荐安装 Event,能够支持巨大的并发连接。如果业务并发连接比较低,例如 1000 以下并发连接,则可以不用安装。
常见问题
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 扩展先加载。