proc_get_status
Get information about a process opened by proc_open
&reftitle.description;
arrayproc_get_status
resourceprocess
proc_get_status fetches data about a
process opened using proc_open.
&reftitle.parameters;
process
The proc_open resource that will
be evaluated.
&reftitle.returnvalues;
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 -1.
cached
bool
As of PHP 8.3.0, this is &true; when the exit code is cached.
Caching is necessary to make sure the exit code is not lost by
subsequent calls to process APIs.
termsig
int
The number of the signal that caused the child process to terminate
its execution (only meaningful if signaled is &true;).
stopsig
int
The number of the signal that caused the child process to stop its
execution (only meaningful if stopped is &true;).
&reftitle.changelog;
&Version;
&Description;
8.3.0
The "cached" entry has been added to the returned
array. Prior to PHP 8.3.0, only the first call returned the real exit
code. The "cached" entry indicates that the exit code
was cached.
&reftitle.seealso;
proc_open