PHP マニュアル: 待つかフォークした子プロセスのステータスを返す

説明

int pcntl_wait(int &$status, int $flags = 0, array &$resource_usage = [])

この関数は、子プロセスが終了する・カレントのプロセスを終了させるシグナルが送信される・シグナル処理関数をコールするシグナルが送信されるのいずれかが発生するまでカレントのプロセスの実行を中断します。子プロセスが、コール時に既に終了している場合("ゾンビ"プロセスと呼ばれます)、この関数は直ちに処理を返します。子プロセスにより使用される全てのシステムリソースは、解放されます。waitpid のシステムでの動作に関する詳細は、システムの wait(2) についての man ページを参照ください。

注意:
この関数は、process_id に -1 を指定し、flags を何も設定せずに pcntl_waitpid をコールするのと等価です。

パラメータ

status

pcntl_wait は、パラメータ status の中にステータス情報を保存します。このステータスは、次の関数を用いて評価可能です。 pcntl_wifexited、 pcntl_wifstopped、 pcntl_wifsignaled、 pcntl_wexitstatus、 pcntl_wtermsig および pcntl_wstopsig 。

flags

システム上で wait3 が使用可能な場合 (ほとんどの BSD 系システムが該当します)、オプションのパラメータ flags を使用可能です。このパラメータが指定されない場合、wait はシステムコールに対して使用されます。wait3 が使用できない場合、flags に値を設定しても何の影響も及ぼしません。 flags の値は、次の 2 つのグローバル定数のゼロまたはそれ以上の論理和です。

**`flags` のとりうる値**
`WNOHANG`	子プロセスが終了していない場合に直ちに処理を返します。
`WUNTRACED`	停止した子プロセスの場合に処理を返します。そして、ステータスは報告されません。

戻り値

pcntl_wait は、終了した子プロセスのプロセス ID を返します。エラーの場合は -1、(wait3 が使用可能なシステムで) WNOHANG が使用され、子プロセスが利用できない場合に 0 を返します。

参考

pcntl_fork
pcntl_signal
pcntl_wifexited
pcntl_wifstopped
pcntl_wifsignaled
pcntl_wexitstatus
pcntl_wtermsig
pcntl_wstopsig
pcntl_waitpid