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émentTypeDescription
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