<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.proc-get-status" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>proc_get_status</refname>

<refpurpose>Liefert Informationen über einen mit <function>proc_open</function>

gestarteten Prozess</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>array</type><methodname>proc_get_status</methodname>

<methodparam><type>resource</type><parameter>process</parameter></methodparam>

</methodsynopsis>

<para>

<function>proc_get_status</function> liefert Daten über einen Prozess, der

unter Verwendung von <function>proc_open</function> gestartet wurde.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>process</parameter></term>

<listitem>

<para>

Die zu untersuchende <function>proc_open</function>-<type>Ressource</type>.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Im Erfolgsfall wird ein <type>Array</type> der gesammelten Informationen

zurückgegeben.

Das zurückgegebene Array enthält die folgenden Elemente:

</para>

<para>

<informaltable>

<tgroup cols="3">

<thead>

<row>

<entry>Element</entry>

<entry>Typ</entry>

<entry>Beschreibung</entry>

</row>

</thead>

<tbody>

<row>

<entry>command</entry>

<entry><type>string</type></entry>

<entry>

Der Kommandostring, der an <function>proc_open</function> übergeben wurde.

</entry>

</row>

<row>

<entry>pid</entry>

<entry><type>int</type></entry>

<entry>ProzessID</entry>

</row>

<row>

<entry>running</entry>

<entry><type>bool</type></entry>

<entry>

Ist &true;, wenn der Prozess noch läuft, und &false; wenn er beendet wurde.

</entry>

</row>

<row>

<entry>signaled</entry>

<entry><type>bool</type></entry>

<entry>

Ist &true;, wenn der Child-Prozess durch ein nicht erkanntes Signal

beendet wurde. Unter Windows hat das Element immer den Wert &false;.

</entry>

</row>

<row>

<entry>stopped</entry>

<entry><type>bool</type></entry>

<entry>

Ist &true;, wenn der Child-Prozess durch ein Signal gestoppt wurde.

Unter Windows hat das Element immer den Wert &false;.

</entry>

</row>

<row>

<entry>exitcode</entry>

<entry><type>int</type></entry>

<entry>

Der Exitcode, der vom Prozess zurückgegeben wurde (dieser ist nur

aussagekräftig, wenn <literal>running</literal> &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 <literal>-1</literal>.

</entry>

</row>

<row>

<entry>cached</entry>

<entry><type>bool</type></entry>

<entry>

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.

</entry>

</row>

<row>

<entry>termsig</entry>

<entry><type>int</type></entry>

<entry>

Die Signalnummer die den Child-Prozess veranlasst hat, seine Ausführung

abzubrechen (nur aussagekräftig, wenn <literal>signaled</literal>

&true; ist).

</entry>

</row>

<row>

<entry>stopsig</entry>

<entry><type>int</type></entry>

<entry>

Die Signalnummer, die den Child-Prozess veranlasst hat, seine Ausführung

zu stoppen (nur aussagekräftig, wenn <literal>stopped</literal>

&true; ist).

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.3.0</entry>

<entry>

Der Eintrag <literal>"cached"</literal> 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 <literal>"cached"</literal> zeigt an, dass

der Exit-Code zwischengespeichert wurde.

was cached.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>proc_open</function></member>

</simplelist>

</para>

</refsect1>

</refentry>