(PHP 5, PHP 7, PHP 8)
pcntl_wait — 等待或返回 fork 的子進(jìn)程狀態(tài)
&$status
, int $options
= 0, array &$rusage
= ?): intwait函數掛起當前進(jìn)程的執行直到一個(gè)子進(jìn)程退出或接收到一個(gè)信號要求中斷當前進(jìn)程或調用一個(gè)信號處理函數。如果一個(gè)子進(jìn)程在調用此函數時(shí)已經(jīng)退出(俗稱(chēng)僵尸進(jìn)程),此函數立刻返回。子進(jìn)程使用的所有系統資源將被釋放。關(guān)于 wait 在您系統上工作的詳細規范請查看您系統的 wait(2)手冊。
注意:
這個(gè)函數等同于以
-1
作為參數pid
的值并且沒(méi)有options
參數來(lái)調用 pcntl_waitpid() 函數。
status
pcntl_wait() 將會(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_wait() 返回退出的子進(jìn)程進(jìn)程號,發(fā)生錯誤時(shí)返回 -1,如果提供了 WNOHANG 作為 option(wait3可用的系統)并且沒(méi)有可用子進(jìn)程時(shí)返回 0。