安裝說明

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

Composer 安裝:

composer require workerman/workerman

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

windows 用戶(必讀)

從 workerman 3.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 擴展先加載。