インストール説明

Workermanは実際にはPHPコードパッケージです。あなたのPHP環境がすでに整っている場合、Workermanのソースコードまたはデモをダウンロードするだけで実行可能です。

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でインストールされていない場合は、マニュアルの付録-拡張モジュールのインストールの方法3からソースコードをコンパイルしてインストールしてください。

debian/ubuntu/mac osシステム
マニュアルの付録-拡張モジュールのインストールの方法3からソースコードをコンパイルしてインストールしてください。

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と入力してEnterを押します。他はそのままEnterを押します。

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と入力してEnterを押します。他はそのままEnterを押します。

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と入力してEnterを押します。他はそのままEnterを押します。

3、php --iniを実行してphp.iniファイルを見つけて開き、最後の行に以下の設定を追加します。

extension=event.so

4、コマンドラインで実行します(このステップはgithubからWorkermanのメインプログラムをダウンロードするものです)。

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

5、入門ガイド--簡単な開発事例部分を参考にしてエントリーファイルを書いて実行します。
または公式サイトからパッケージ化されたデモをダウンロードして実行します。

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と入力してEnterを押します。他はそのままEnterを押します。

3、php --iniを実行してphp.iniファイルを見つけて開き、最後の行に以下の設定を追加します。

extension=event.so

4、コマンドラインで実行します(このステップはgithubからWorkermanのメインプログラムをダウンロードするものです)。

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

5、入門ガイド--簡単な開発事例部分を参考にしてエントリーファイルを書いて実行します。
または公式サイトからパッケージ化されたデモをダウンロードして実行します。

mac osシステムのインストールガイド

方法1: macシステムにはPHP Cliが標準で付属していますが、pcntl拡張が欠如している場合があります。

1、マニュアルの付録-拡張モジュールのインストールの方法3を参考にして、pcntl拡張をソースからコンパイルしてインストールします。

2、マニュアルの付録-拡張モジュールのインストールの方法4を参考にして、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.soextension=event.soの前に書いてsocket拡張を先に読み込ませる必要があります。