Skip to content

安装说明

Workerman 实际上就是一个 PHP 代码包,如果你的 PHP 环境已经装好,只需要把 Workerman 源代码或者 demo 下载下来即可运行。

Composer 安装:

sh
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 包,命令行运行

shell
yum install libevent-devel -y
# 如果无法安装,尝试使用下面的命令
# yum install libevent2-devel -y

2、安装 event 扩展,命令行运行 (event 扩展要求 PHP>=5.4)

shell
pecl install event

注意提示: Include libevent OpenSSL support [yes] : 时输入 no 回车,其它直接敲回车就行

3、运行 php --ini 找到并打开 php.ini 文件,在最后一行加入如下配置

shell
extension=event.so

debian/ubuntu 系统安装

1、安装 event 扩展依赖的 libevent-dev 包,命令行运行

shell
apt-get install libevent-dev -y
# 如果无法安装,请尝试以下命令
# apt-get install libevent2-dev -y

2、安装 event 扩展,命令行运行

shell
pecl install event

注意提示: Include libevent OpenSSL support [yes] : 时输入 no 回车,其它直接敲回车就行

3、运行 php --ini 找到并打开 php.ini 文件,在最后一行加入如下配置

shell
extension=event.so

mac os 系统安装教程

mac 系统一般作为开发机,不必安装 event 扩展。

全新系统安装(全新安装 PHP + 扩展)

centos 系统安装教程

1、命令行运行(此步骤包含了安装 php-cli 主程序以及 pcntl、posix、libevent 库及 git 程序)

shell
yum install php-cli php-process git gcc php-devel php-pear libevent-devel -y

2、安装 event 扩展,命令行运行 (注意:event 扩展要求 PHP>=5.4)

shell
pecl install event

注意提示: Include libevent OpenSSL support [yes] : 时输入 no 回车,其它直接敲回车就行

3、运行 php --ini 找到并打开 php.ini 文件,在最后一行加入如下配置

shell
extension=event.so

4、命令行运行(此步骤是通过 github 下载 Workerman 主程序)

shell
git clone https://github.com/walkor/Workerman

5、参考入门指引 -- 简单开发实例部分写入口文件运行。 或者从官网下载打包好的 demo 运行。

debian/ubuntu 系统安装教程

1、命令行运行(此步骤包含了安装 php-cli 主程序、libevent 库及 git 程序)

shell
apt-get install php-cli git gcc php-pear php-dev libevent-dev -y

2、安装 event 扩展,命令行运行 (注意:event 扩展要求 PHP>=5.4)

shell
pecl install event

注意提示: Include libevent OpenSSL support [yes] : 时输入 no 回车,其它直接敲回车就行

3、运行 php --ini 找到并打开 php.ini 文件,在最后一行加入如下配置

shell
extension=event.so

4、命令行运行(此步骤是通过 github 下载 Workerman 主程序)

shell
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 扩展先加载。

基于 MIT 许可发布