Lit les informations concernant un processus ouvert par proc_open

# proc_get_status

(PHP 5, PHP 7, PHP 8)

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

### Description

function 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 non intercepté. 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 (significatif uniquement si l'élément `running` vaut `false`). Avant PHP 8.3.0, seul le premier appel de cette fonction retournait la vraie valeur, les appels suivants retournaient `-1`.
cached | bool | À partir de PHP 8.3.0, vaut `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 des processus.
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 `stopped` vaut `true`).

### Historique

Version | Description
--- | ---
8.3.0 | L'entrée `"cached"` a été ajoutée au tableau retourné. Avant PHP 8.3.0, seul le premier appel retournait le vrai code de sortie. L'entrée `"cached"` 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open