(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_waitpid — Wartet auf ein abgezweigtes Kind oder gibt dessen Status zurück
Unterbricht die Ausführung des aktuellen Prozesses bis der durch den
Parameter process_id angegebene Kindprozess beendet
ist oder bis ein Signal gesendet wird, um den aktuellen Prozess zu beenden
oder eine Signalverabeitungsfunktion aufzurufen.
Wenn der durch process_id angegebene Kindprozess zum
Zeitpunkt des Funktionsaufrufs bereits beendet ist (ein sog.
"Zombie"-Prozess), kehrt die Funktion umgehend zurück. Alle durch den
Kindprozess verwendeten Ressourcen werden freigegeben. Spezifische Details,
wie waitpid auf dem jeweiligen System funktioniert, sind in der
waitpid(2)-Manpage des Systems zu finden.
process_id
Der Wert von process_id kann einer der Folgenden
sein:
< -1 |
wartet auf einen beliebigen Kindprozess dessen Prozessgruppen-ID
gleich dem absoluten Wert von process_id ist.
|
-1 |
wartet auf einen beliebigen Kindprozess; dies ist dasselbe Verhalten, welches die Funktion wait anbietet. |
0 |
wartet auf einen beliebigen Kindprozess, dessen Prozessgruppen-ID gleich dem Wert des aufrufenden Prozesses ist. |
> 0 |
wartet auf das Kind, dessen Prozess-ID gleich dem Wert von
process_id ist.
|
Hinweis:
Wenn
process_idauf-1gesetzt wird, entspricht dies der Funktiononalität von pcntl_wait() (ohneflags).
status
pcntl_waitpid() speichert Statusinformationen im
Parameter status, welcher durch die folgenden
Funktionen ausgewertet werden kann:
pcntl_wifexited(),
pcntl_wifstopped(),
pcntl_wifsignaled(),
pcntl_wexitstatus(),
pcntl_wtermsig() und
pcntl_wstopsig().
flags
Der Wert von flags ist der Wert von keiner oder
mehr der mittels OR verknüpften folgenden beiden
globalen Konstanten:
WNOHANG |
Gebe umgehend zurück, wenn kein Kind beendet wurde. |
WUNTRACED |
Gebe bei Kindern zurück, die angehalten wurden und deren Status nicht gemeldet wurde. |
pcntl_waitpid() gibt entweder die Prozess-ID des Kindes
zurück, das beendet wurde, -1 im Fehlerfall, oder 0, wenn
WNOHANG verwendet wurde und kein Kind verfügbar war.
please note, if you using configure option --enable-sigchild(Enable PHP's own SIGCHLD handler) when complie php(under linux 2.6.18-53.1.13.el5.centos.plus and php 5.2.5 as I know), pcntl_waitpid and pcntl_wait in php script would never return the child pid, because the build in handle get it first.<?php
$childs = array();
// Fork some process.
for($i = 0; $i < 10; $i++) {
$pid = pcntl_fork();
if($pid == -1)
die('Could not fork');
if ($pid) {
echo "parent \n";
$childs[] = $pid;
} else {
// Sleep $i+1 (s). The child process can get this parameters($i).
sleep($i+1);
// The child process needed to end the loop.
exit();
}
}
while(count($childs) > 0) {
foreach($childs as $key => $pid) {
$res = pcntl_waitpid($pid, $status, WNOHANG);
// If the process has already exited
if($res == -1 || $res > 0)
unset($childs[$key]);
}
sleep(1);
}
?><?php
declare(ticks = 1);
function zp_handler($signal) {
$id = pcntl_waitpid(-1, $status, WNOHANG);
if (pcntl_wifexited($status))
{
printf("Removed Chlid id: %d \n",$id);
printf("Chlid status: %d \n",pcntl_wexitstatus($status));
}
}
//pcntl_signal_dispatch();
pcntl_signal(SIGCHLD, "zp_handler");
//pcntl_signal_dispatch();
//
$pid = pcntl_fork();
if ($pid == 0)
{
print "#1 Hi, I'm child process".PHP_EOL;
sleep(3);
return 10;
}
else
{
print "#1parent process id:".$pid.PHP_EOL;
$pid = pcntl_fork();
if ($pid == 0)
{ print "#2 Hi, I'm child process".PHP_EOL;
sleep(10);
exit(20);
}
else
{
print "#2parent process id:".$pid.PHP_EOL;
for ($i=0; $i <10 ; $i++) {
print "wait..".PHP_EOL;
sleep(10);
}
}
}
?>