安裝說明

Workerman實際上就是一個PHP代碼包，如果你的PHP環(huán)境已經裝好，只需要把Workerman源代碼或者demo下載下來即可運行。

Composer安裝：

composer require workerman/workerman

注意
有些composer代理鏡像不全，使用以上命令composer config -g --unset repos.packagist 移除代理

windows用戶（必讀）

從workerman3.5.3版開始workerman已經可以同時支持windows和linux系統(tǒng)。
windows用戶需要配置下php環(huán)境變量。

===本頁面以下僅適用于Linux環(huán)境workerman，windows用戶請忽略===

Linux系統(tǒng)環(huán)境檢測

Linux系統(tǒng)可以使用以下腳本測試本機PHP環(huán)境是否滿足Workerman運行要求。
curl -Ss http://www.wtbis.cn/check | php

上面腳本如果全部顯示ok，則代表滿足Workerman要求，直接到官網下載例子即可運行。

如果不是全部ok，則參考下面文檔安裝缺失的擴展即可。

（注意：檢測腳本中沒有檢測event擴展，如果業(yè)務并發(fā)連接數大于1024必須安裝event擴展，并且優(yōu)化Linux內核，擴展安裝方法參照下面說明）

已有PHP環(huán)境安裝缺失擴展

安裝pcntl和posix擴展：

centos系統(tǒng)
如果php是通過yum安裝的，則命令行運行 yum install php-process即可安裝pcntl和posix擴展。

如果安裝失敗或者php本身不是用yum安裝的請參考手冊附錄-安裝擴展一節(jié)中方法三源碼編譯安裝。

debian/ubuntu/mac os系統(tǒng)
參考手冊附錄-安裝擴展一節(jié)中方法三源碼編譯安裝。

安裝event擴展：

為了能支持更大的并發(fā)連接數，必須安裝event擴展，并且優(yōu)化Linux內核。安裝方法如下:

centos系統(tǒng)

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系統(tǒng)安裝

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 系統(tǒng)安裝教程

mac 系統(tǒng)一般作為開發(fā)機，不必安裝event擴展。

全新系統(tǒng)安裝（全新安裝PHP+擴展）

centos系統(tǒng)安裝教程

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、參考入門指引--簡單開發(fā)實例部分寫入口文件運行。
或者從官網下載打包好的demo運行。

debian/ubuntu系統(tǒng)安裝教程

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、參考入門指引--簡單開發(fā)實例部分寫入口文件運行。
或者從官網下載打包好的demo運行。

mac os 系統(tǒng)安裝教程

方法1： mac系統(tǒng)自帶PHP Cli，但是可能缺少pcntl擴展。

1、參考手冊附錄-安裝擴展一節(jié)中方法三源碼編譯安裝pcntl擴展。

2、參考手冊附錄-安裝擴展一節(jié)中方法四利用phpize安裝event擴展（作為開發(fā)機此可省略）。

3、通過http://www.wtbis.cn/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擴展不是必須的，當業(yè)務需要支撐大于1000的并發(fā)連接時，推薦安裝Event，能夠支持巨大的并發(fā)連接。如果業(yè)務并發(fā)連接比較低，例如1000以下并發(fā)連接，則可以不用安裝。

常見問題

1、如果出現如下報錯 checking for include/event2/event.h... not found，請先嘗試刪除libevent-dev(el)庫安并裝libevent2-dev(el)。
centos系統(tǒng)：yum remove libevent-devel && yum install libevent2-devel
debian/ubuntu系統(tǒng)：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擴展先加載。