# pcntl_waitpid

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

pcntl_waitpid — Attend la fin de l'exécution d'un processus fils

### Description

pcntl_waitpid(
int `$process_id`,
int `&$status`,
int `$flags` = 0,
array `&$resource_usage` = []
): int

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.

### Liste de paramètres

`process_id`

  La valeur de `process_id` peut être une parmi les suivantes :

  Valeurs possibles pour `process_id`
  `< -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_id` vaut `-1`, cela équivaut à utiliser la fonction pcntl_wait() (moins `flags`).

`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`) :

  Valeurs possibles de `flags`
  `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.

### 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