# proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_status — Liefert 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open