(PHP 5, PHP 7, PHP 8)
proc_get_status — Lit les informations concernant un processus ouvert par proc_open()
proc_get_status() lit les données concernant le
processus process créé avec la fonction
proc_open().
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, 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).
|
| 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.
|