proc_get_status()

proc_get_status() — Get information about a process opened by proc_open().

Built-in function of PHP 8.5. The manual lists it as available in PHP 5, PHP 7, PHP 8. This page is the reference card: signature, parameters and return value, plus the changelog and the example the manual provides.

Signature

proc_get_status(resource $process): array

Parameters

Return value

An array of collected information. The returned array contains the following elements: elementtypedescription command string The command string that was passed to proc_open(). pid int process id running bool true if the process is still running, false if it has terminated. signaled bool true if the child process has been terminated by an uncaught signal. Always set to false on Windows. stopped bool true if the child process has been stopped by a signal. Always set to false on Windows. exitcode int The exit code returned by the process (which is only meaningful if running is false). Prior to PHP 8.3.0, only the first call of this function returned the real value, the following calls returned ...

Example

The PHP manual ships no example for proc_get_status(); the signature and the parameter table above are the contract.

Changelog

See also

proc_open()

All PHP 8.5 built-in functions

Reference card built from the PHP manual page proc_get_status() (PHP documentation, CC BY 3.0). The page is generated from the manual, so the wording of the parameter and return value text follows php.net.