proc_get_status

(PHP 5, PHP 7)

proc_get_statusObtiene información sobre un proceso abierto por proc_open()

Descripción

proc_get_status ( resource $process ) : array

proc_get_status() recupera información sobre un proceso abierto mediante el uso de proc_open().

Parámetros

process

El resource proc_open() que será evaluado.

Valores devueltos

Un valor array con la información recolectada en caso de éxito, y FALSE si ocurre un error. La matriz devuelta contiene los siguientes elementos:

elementtypedescription
command string La cadena del comando que fue pasada a proc_open().
pid int process id
running bool TRUE si el proceso aun está siendo ejecutado, FALSE si ha terminado.
signaled bool TRUE si el proceso hijo ha sido terminado por una señal no atrapada. En windows, este valor siempre es FALSE.
stopped bool TRUE si el proceso hijo fue detenido por una señal. En windows, este valor siempre es FALSE.
exitcode int El código de salida devuelto por el proceso (el cual tiene sentido únicamente si running es FALSE). Solo la primera llamada a esta función devuelve el valor real, la siguiente llamada devuelve -1.
termsig int El número de la señal que causó que el proceso hijo finalizara su ejecución (sólo tiene sentido si signaled es TRUE).
stopsig int El número de la señal que causó que el proceso hijo detuviera su ejecución (sólo tiene sentido si stopped es TRUE).

Ver también

  • proc_open() - Ejecuta un comando y abre un puntero de fichero para entrada/salida