pcntl_wait
Please note that you must use bitwise OR | in the following:
"The value of options is the value of zero or more of the following two global constants OR'ed together"
i.e.
WNOHANG | WUNTRACED
pcntl_waitpid
(PHP 4 >= 4.1.0, PHP 5)
pcntl_waitpid — Attend la fin de l'exécution d'un processus fils
Description
int pcntl_waitpid
( int
$pid
, int &$status
[, int $options = 0
] )
Suspend l'exécution du processus courant jusqu'à ce qu'un processus fils
spécifié par le paramètre pid ait terminé,
qu'un signal ait mis fin à ce processus ou qu'un signal ait appelé un gestionnaire
de signaux.
Si le processus fils identifié par pid est déjà
terminé au moment de l'appel de cette fonction (on les appelle
des processus "zombie"), la fonction se termine immédiatement.
Toute ressource système utilisée par le processus fils est libérée.
Reportez-vous à la page de man waitpid(2) pour avoir des détails
sur le comportement de cette fonction sur votre système.
Liste de paramètres
-
pid -
La valeur de
pidpeut être une parmi les suivantes :Valeurs possibles pour pid< -1 attend que tous les processus fils dont l'identifiant de groupe est égal à la valeur absolue de pidsoient terminés.-1 attend que tous les processus fils soient terminés. Ceci est le même comportement que celui de la fonction pcntl_wait(). 0 attend que tous les processus fils dont l'identifiant de groupe est égal à celui du processus courant soient terminés. > 0 attend que le processus fils dont l'identifiant est égal à pidsoit terminé.Note:
Si
pidvaut -1, cela équivaut à utiliser la fonction pcntl_wait() (minimumoptions). -
status -
pcntl_waitpid() enregistrera des informations sur le statut courant du processus dans le paramètre
status, auquel on peut accéder grâce aux fonctions suivantes : pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() et pcntl_wstopsig(). -
options -
Le paramètre
optionspeut prendre la valeur zéro, ou plusieurs des constantes globales suivantes (combinez les avec l'opérateur OR) :Valeurs possibles de optionsWNOHANG retourne immédiatement si aucun processus fils ne s'est terminé. WUNTRACED retourne lorsque les processus fils sont arrêtés et que leur statut n'a pas été mis à jour.
Valeurs de retour
pcntl_waitpid() retourne l'identifiant de
processus du processus fils qui s'est terminé, ou bien -1 en cas
d'erreur ou encore zéro si WNOHANG a été utilisée
et qu'aucun processus fils n'était disponible.
Voir aussi
- pcntl_fork() - Duplique le process courant
- pcntl_signal() - Installe un gestionnaire de signaux
- pcntl_wifexited() - Vérifie si le code de retour représente une fin normale
- pcntl_wifstopped() - Retourne TRUE si le processus fils est stoppé
- pcntl_wifsignaled() - Retourne TRUE si le code statut représente une fin due à un signal
- pcntl_wexitstatus() - Retourne le code d'un processus fils terminé
- pcntl_wtermsig() - Retourne le signal qui a provoqué la fin du processus fils
- pcntl_wstopsig() - Retourne le signal qui a causé l'arrêt du processus fils
add a note
User Contributed Notes
pcntl_waitpid
brian dot ngure at gmail dot com
08-Jul-2009 08:03
tunderzone at gmail dot com
25-Jun-2009 06:26
A better way to do this and not end up having zombie processes until all child processes ends is like this:
<?php
$i = 0;
$starttime = microtime(TRUE);
$pid_arr = array();
while ($i < intval($argv[1]))
{
$pid = pcntl_fork();
if ($pid == -1)
{
die('could not fork');
}
else
{
if ($pid) // parent
{
$pid_arr[$i] = $pid;
}
else // child
{
performSomeFunction($i+1);
}
}
$i++;
}
while(count($pid_arr) > 0)
{
$myId = pcntl_waitpid(-1, $status, WNOHANG);
foreach($pid_arr as $key => $pid)
{
if($myId == $pid) unset($pid_arr[$key]);
}
usleep(100);
}
$elapsed = microtime(TRUE) - $starttime;
print "\n==> total elapsed: " . sprintf("%f secs.\n", $elapsed);
?>
saguto dot l7cc at gmail dot com
09-Apr-2008 09:09
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.
Kevin
10-May-2006 03:40
---
while ($i < intval($argv[1]))
{
$pid = pcntl_fork();
if ($pid == -1)
{
die('could not fork');
}
else
{
if ($pid) // parent
{
$pid_arr[$i] = $pid;
}
else // child
{
performSomeFunction($i+1);
}
}
$i++;
}
---
careful, this will create a lot more children than you probably expect. You must return or exit after performSomeFunction($i+1); ie,
else // child
{
performSomeFunction($i+1);
exit(0);
}
admin at albert dot us dot com
06-Mar-2006 10:48
Here's a decent example of the pcntl_waitpid() call:
$i = 0;
$starttime = microtime(TRUE);
$pid_arr = array();
while ($i < intval($argv[1]))
{
$pid = pcntl_fork();
if ($pid == -1)
{
die('could not fork');
}
else
{
if ($pid) // parent
{
$pid_arr[$i] = $pid;
}
else // child
{
performSomeFunction($i+1);
}
}
$i++;
}
foreach ($pid_arr as $pid)
{
// we are the parent
pcntl_waitpid($pid, $status);
}
$elapsed = microtime(TRUE) - $starttime;
print "\n==> total elapsed: " . sprintf("%f secs.\n", $elapsed);