# proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_status — Lit les informations concernant un processus ouvert par proc_open()

### Description

proc_get_status(resource `$process`): array

proc_get_status() lit les données concernant le processus `process` créé avec la fonction proc_open().

### Liste de paramètres

`process`

  La resource proc_open() à évaluer.

### Valeurs de retour

Un tableau contenant les informations collectées. Le tableau retourné contient les éléments suivants :

Élément | Type | Description
--- | --- | ---
command | chaîne de caractères | La commande passée à la fonction proc_open().
pid | entier | identifiant du processus
running | booléen | `true` si le processus fonctionne toujours et `false` s'il est terminé.
signaled | booléen | `true` si le processus fils a été terminé par un signal inconnu. Toujours défini à `false` sous Windows.
stopped | booléen | `true` si le processus fils a été stoppé par un signal. Toujours défini à `false` sous Windows.
exitcode | entier | Le code retourné par le processus (uniquement si l'élément `running` vaut `false`). Avant PHP 8.3.0, seule la première appel de cette fonction retournait la vraie valeur, les appels suivants retournaient `-1`.
mis en cache | bool | À partir de PHP 8.3.0, ceci est `true` lorsque le code de sortie est mis en cache. La mise en cache est nécessaire pour s'assurer que le code de sortie n'est pas perdu lors des appels suivants aux API de traitement.
termsig | entier | le numéro du signal qui a causé la fin de l'exécution du processus fils (uniquement significatif si `signaled` vaut `true`).
stopsig | entier | le numéro du signal qui a causé l'arrêt de l'exécution du processus fils (uniquement significatif si `signaled` vaut `true`).

### Historique

Version | Description
--- | ---
8.3.0 | L'entrée `"mis en cache"` a été ajoutée au tableau retourné. Avant PHP 8.3.0, seule la première appel retournait le vrai code de sortie. L'entrée `"mis en cache"` indique que le code de sortie a été mis en cache.

### Voir aussi

- proc_open() - Exécute une commande et ouvre les pointeurs de fichiers pour les entrées / sorties