安裝說明

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擴展先加載。