(PHP 5, PHP 7, PHP 8)
proc_get_status — Liefert Informationen über einen mit proc_open() gestarteten Prozess
proc_get_status() liefert Daten über einen Prozess, der unter Verwendung von proc_open() gestartet wurde.
Im Erfolgsfall wird ein Array der gesammelten Informationen zurückgegeben. Das zurückgegebene Array enthält die folgenden Elemente:
Element | Typ | Beschreibung |
---|---|---|
command | string | Der Kommandostring, der an proc_open() übergeben wurde. |
pid | int | ProzessID |
running | bool |
Ist true , wenn der Prozess noch läuft, und false wenn er beendet wurde.
|
signaled | bool |
Ist true , wenn der Child-Prozess durch ein nicht erkanntes Signal
beendet wurde. Unter Windows hat das Element immer den Wert false .
|
stopped | bool |
Ist true , wenn der Child-Prozess durch ein Signal gestoppt wurde.
Unter Windows hat das Element immer den Wert false .
|
exitcode | int |
Der Exitcode, der vom Prozess zurückgegeben wurde (dieser ist nur
aussagekräftig, wenn running false ist).
Vor PHP 8.3.0 gab nur der erste Aufruf der Funktion den richtigen Wert
zurück, die folgenden Aufrufe resultierten im Wert -1 .
|
cached | bool |
Seit PHP 8.3.0 ist dies true , wenn der Exit-Code zwischengespeichert
wird. Die Zwischenspeicherung ist notwendig, um sicherzustellen, dass
der Exit-Code bei nachfolgenden Aufrufen von Prozess-APIs nicht
verlorengeht.
|
termsig | int |
Die Signalnummer die den Child-Prozess veranlasst hat, seine Ausführung
abzubrechen (nur aussagekräftig, wenn signaled
true ist).
|
stopsig | int |
Die Signalnummer, die den Child-Prozess veranlasst hat, seine Ausführung
zu stoppen (nur aussagekräftig, wenn stopped
true ist).
|
Version | Beschreibung |
---|---|
8.3.0 |
Der Eintrag "cached" wurde dem zurückgegebenen Array
hinzugefügt. Vor PHP 8.3.0 gab nur der erste Aufruf den tatsächlichen
Exit-Code zurück. Der Eintrag "cached" zeigt an, dass
der Exit-Code zwischengespeichert wurde.
was cached.
|