proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_statusGet information about a process opened by proc_open()

Description

proc_get_status(resource$process): array

proc_get_status() fetches data about a process opened using proc_open().

Parameters

process

The proc_open()resource that will be evaluated.

Return Values

An array of collected information. The returned array contains the following elements:

elementtypedescription
commandstring The command string that was passed to proc_open().
pidintprocess id
runningbooltrue if the process is still running, false if it has terminated.
signaledbooltrue if the child process has been terminated by an uncaught signal. Always set to false on Windows.
stoppedbooltrue if the child process has been stopped by a signal. Always set to false on Windows.
exitcodeint The exit code returned by the process (which is only meaningful if running is false). Only first call of this function return real value, next calls return -1.
termsigint The number of the signal that caused the child process to terminate its execution (only meaningful if signaled is true).
stopsigint The number of the signal that caused the child process to stop its execution (only meaningful if stopped is true).

See Also

  • proc_open() - Execute a command and open file pointers for input/output
To Top