array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pcntl-wait.php', 1 => 'pcntl_wait', 2 => 'Attend ou retourne le statut d\'un processus fils', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'Fonctions PCNTL', ), 'prev' => array ( 0 => 'function.pcntl-unshare.php', 1 => 'pcntl_unshare', ), 'next' => array ( 0 => 'function.pcntl-waitid.php', 1 => 'pcntl_waitid', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/pcntl/functions/pcntl-wait.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pcntl_wait

(PHP 5, PHP 7, PHP 8)

pcntl_wait — Attend ou retourne le statut d'un processus fils

Description

pcntl_wait(int &$status, int $flags = 0, array &$resource_usage = []): int

pcntl_wait() suspend l'exécution du processus courant jusqu'à ce qu'un des processus fils soit terminé, ou qu'un signal soit envoyé pour terminer le processus courant ou pour appeler un gestionnaire. Si le processus est déjà terminé au moment de l'appel de la fonction, c'est-à-dire si le processus est un zombie, alors la fonction se termine immédiatement. Toutes les ressources système utilisées par le processus fils sont libérées. Consulter le manuel du système à wait(2) pour avoir des détails spécifiques sur le fonctionnement de wait() sur celui-ci.

Note:

Cette fonction est équivalente à appeler la fonction pcntl_waitpid() avec un process_id valant -1 et aucun flags.

Liste de paramètres

status

pcntl_wait() va stocker les informations de statut dans le paramètre status qui peut être lu avec les fonctions suivantes : pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() et pcntl_wstopsig().

flags

Si wait3 est disponible sur le système (c'est le cas de la plupart des systèmes BSD-), il est possible d'ajouter le paramètre optionnel flags. S'il n'est pas fourni, wait() sera utilisé pour l'appel système. Si wait3 n'est pas disponible, le paramètre flags n'aura pas d'effet. La valeur de flags est la combinaison de zéro ou plusieurs des constantes suivantes :
Valeurs possibles pour flags
WNOHANG Termine immédiatement si aucun processus ne s'est terminé.
WUNTRACED Termine pour les processus qui sont stoppés, et pour ceux dont le résultat n'a pas été rapporté.

Valeurs de retour

pcntl_wait() retourne l'identifiant de processus qui s'est terminé, -1 en cas d'erreur ou zéro si WNOHANG a été fourni comme option (disponible sur les systèmes wait3), et qu'aucun processus fils n'était disponible.

Voir aussi