(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_waitpid — 等待或返回fork的子進(jìn)程狀態(tài)
$pid, int &$status, int $options = 0): int
掛起當前進(jìn)程的執行直到參數pid指定的進(jìn)程號的進(jìn)程退出，
或接收到一個(gè)信號要求中斷當前進(jìn)程或調用一個(gè)信號處理函數。
如果pid指定的子進(jìn)程在此函數調用時(shí)已經(jīng)退出（俗稱(chēng)僵尸進(jìn)程），此函數
將立刻返回。關(guān)于waitpid更詳細的規范請參見(jiàn)您系統的waitpid（2）手冊。
pid
參數pid的值可以是以下之一：
< -1 |
等待任意進(jìn)程組ID等于參數pid給定值的絕對值的進(jìn)程。
|
-1 |
等待任意子進(jìn)程;與pcntl_wait函數行為一致。 |
0 |
等待任意與調用進(jìn)程組ID相同的子進(jìn)程。 |
> 0 |
等待進(jìn)程號等于參數pid值的子進(jìn)程。
|
注意:
指定
-1作為pid的值等同于pcntl_wait() 提供(負的options)。
status
pcntl_waitpid()將會(huì )存儲狀態(tài)信息到status
參數上，這個(gè)通過(guò)status參數返回的狀態(tài)信息可以用以下函數
pcntl_wifexited(),
pcntl_wifstopped(),
pcntl_wifsignaled(),
pcntl_wexitstatus(),
pcntl_wtermsig()以及
pcntl_wstopsig()獲取其具體的值。
options
如果您的操作系統（多數BSD類(lèi)系統）允許使用wait3，您可以提供可選的options
參數。如果這個(gè)參數沒(méi)有提供，wait將會(huì )被用作系統調用。如果wait3不可用，提供參數
options不會(huì )有任何效果。options的值可以是0
或者以下兩個(gè)常量或兩個(gè)常量“或運算”結果（即兩個(gè)常量代表意義都有效）。
WNOHANG |
如果沒(méi)有子進(jìn)程退出立刻返回。 |
WUNTRACED |
子進(jìn)程已經(jīng)退出并且其狀態(tài)未報告時(shí)返回。 |
pcntl_waitpid()返回退出的子進(jìn)程進(jìn)程號，發(fā)生錯誤時(shí)返回-1,如果提供了
WNOHANG作為option（wait3可用的系統）并且沒(méi)有可用子進(jìn)程時(shí)返回0。