PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_waitpid — Attend la fin de l'exécution d'un processus fils
$process_id,&$status,$flags = 0,&$resource_usage = []
Suspend l'exécution du processus courant jusqu'à ce qu'un processus fils
spécifié par le paramètre process_id 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 process_id 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.
Se reporter à la page de man waitpid(2) pour avoir des détails
sur le comportement de cette fonction sur le système.
process_id
La valeur de process_id peut être une parmi les suivantes :
< -1 |
attend un processus fils dont l'identifiant de groupe
est égal à la valeur absolue de process_id.
|
-1 |
attend tout processus fils ; cela correspond au même comportement que celui de la fonction pcntl_wait() présente. |
0 |
attend un processus fils dont l'identifiant de groupe est égal à celui du processus courant. |
> 0 |
attend le processus fils dont l'identifiant est
égal à la valeur de process_id.
|
Note:
Si
process_idvaut-1, cela équivaut à utiliser la fonction pcntl_wait() (moinsflags).
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().
flags
Le paramètre flags peut prendre la valeur
zéro, ou plusieurs des constantes globales suivantes
(combinez les avec l'opérateur OR) :
WNOHANG |
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. |
resource_usage
Le paramètre resource_usage est défini sur un
array associatif contenant les statistiques d'utilisation
des ressources du processus enfant. Pour le détail de son contenu, voir
getrusage().
Ceci n'est pris en charge que si l'appel système
wait4(2) est disponible sur le système ; sinon, le
paramètre est laissé inchangé.
Si aucun processus enfant n'a été récolté, c'est-à-dire si la fonction
retourne 0 ou -1, le paramètre est
défini sur un array vide.
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.
Exemple #1 Exemple avec pcntl_waitpid()
<?php
function checkChild(int $pid, bool $wait): void
{
$flags = ($wait ? 0 : WNOHANG);
$deadPid = pcntl_waitpid($pid, $status, $flags, $rusage);
if ($deadPid === -1) {
$errNo = pcntl_get_last_error();
$errMsg = pcntl_strerror($errNo);
print "PARENT pcntl_waitpid FAILED ({$errNo}): {$errMsg}\n";
} elseif ($deadPid === 0) {
print "PARENT pcntl_waitpid: No exited children.\n";
} elseif (pcntl_wifexited($status)) {
print "PARENT pcntl_waitpid: Child PID {$deadPid} exited with status: "
. pcntl_wexitstatus($status) . "\n";
var_dump($rusage);
} else {
print "PARENT pcntl_waitpid: Child PID {$deadPid} was terminated by signal: "
. pcntl_wtermsig($status) . "\n";
}
}
$parentPid = getmypid();
$forkedPid = pcntl_fork();
if ($forkedPid == -1) {
die('Could not fork');
} else if ($forkedPid) {
// Processus parent
print "PARENT {$parentPid} has forked {$forkedPid}\n";
print "PARENT is checking for exited children\n";
checkChild($forkedPid, false);
// Empêche les enfants de rester en "processus zombie"
print "PARENT is waiting for a child to exit\n";
checkChild($forkedPid, true);
print "PARENT is checking for exited children\n";
checkChild($forkedPid, false);
print "PARENT is exiting\n";
} else {
// Processus enfant
$pid = getmypid();
print "CHILD {$pid} is sleeping\n";
sleep(10);
print "CHILD is exiting\n";
exit(7);
}
