proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_status Lee las informaciones concernientes a un proceso abierto por proc_open()

Descripción

proc_get_status(resource $process): array

proc_get_status() lee los datos concernientes al proceso process creado con la función proc_open().

Parámetros

process

El recurso proc_open() a evaluar.

Valores devueltos

Un array que contiene las informaciones recolectadas. El array retornado contiene los siguientes elementos :

ElementoTipoDescripción
command chaîne de caractères El comando pasado a la función proc_open().
pid entier identificador del proceso
running booléen true si el proceso funciona aún y false si ha terminado.
signaled booléen true si el proceso hijo ha sido terminado por un señal desconocido. Siempre definido a false bajo Windows.
stopped booléen true si el proceso hijo ha sido parado por un señal. Siempre definido a false bajo Windows.
exitcode entier El código retornado por el proceso (únicamente si el elemento running vale false). Antes de PHP 8.3.0, solo la primera llamada de esta función retornaba el verdadero valor, las llamadas siguientes retornaban -1.
en caché bool A partir de PHP 8.3.0, esto es true cuando el código de salida está en caché. La caché es necesaria para asegurarse de que el código de salida no se pierde durante las llamadas siguientes a las API de procesamiento.
termsig entier el número del señal que ha causado la terminación de la ejecución del proceso hijo (únicamente significativo si signaled vale true).
stopsig entier el número del señal que ha causado la parada de la ejecución del proceso hijo (únicamente significativo si signaled vale true).

Historial de cambios

Versión Descripción
8.3.0 La entrada "en caché" ha sido añadida al array retornado. Antes de PHP 8.3.0, solo la primera llamada retornaba el verdadero código de salida. La entrada "en caché" indica que el código de salida ha sido puesto en caché.

Ver también

  • proc_open() - Ejecuta un comando y abre los punteros de ficheros para las entradas / salidas