proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_statusLiefert Informationen über einen mit proc_open() gestarteten Prozess

Beschreibung

proc_get_status(resource $process): array

proc_get_status() liefert Daten über einen Prozess, der unter Verwendung von proc_open() gestartet wurde.

Parameter-Liste

process

Die zu untersuchende proc_open()-Ressource.

Rückgabewerte

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).

Changelog

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.

Siehe auch

  • proc_open() - Führt ein Kommando aus und öffnet Dateizeiger für die Ein- und Ausgabe