(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
pcntl_waitpid — Attend la fin de l'exécution d'un processus fils
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. Reportez-vous à la page de man waitpid(2) pour avoir des détails sur le comportement de cette fonction sur votre système.
process_id La valeur de process_id peut être une parmi les suivantes :
< -1 | attend que tous les processus fils dont l'identifiant de groupe est égal à la valeur absolue de process_id soient 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 à process_id soit terminé. |
Note:
Si
process_idvaut-1, cela équivaut à utiliser la fonction pcntl_wait() (moinsflags).
statuspcntl_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. |
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.