<?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>

Lee las informaciones concernientes a un proceso abierto por <function>proc_open</function>

</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> lee los datos concernientes al

proceso <parameter>process</parameter> creado con la función

<function>proc_open</function>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

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

<listitem>

<para>

El &resource; <function>proc_open</function> a evaluar.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Un array que contiene las informaciones recolectadas.

El array retornado contiene los siguientes elementos :

</para>

<para>

<informaltable>

<tgroup cols="3">

<thead>

<row><entry>Elemento</entry><entry>Tipo</entry><entry>Descripción</entry></row>

</thead>

<tbody>

<row>

<entry>command</entry>

<entry>&string;</entry>

<entry>

El comando pasado a la función <function>proc_open</function>.

</entry>

</row>

<row>

<entry>pid</entry>

<entry>&integer;</entry>

<entry>identificador del proceso</entry>

</row>

<row>

<entry>running</entry>

<entry>&boolean;</entry>

<entry>

&true; si el proceso funciona aún y

&false; si ha terminado.

</entry>

</row>

<row>

<entry>signaled</entry>

<entry>&boolean;</entry>

<entry>

&true; si el proceso hijo ha sido terminado por un señal desconocido.

Siempre definido a &false; bajo Windows.

</entry>

</row>

<row>

<entry>stopped</entry>

<entry>&boolean;</entry>

<entry>

&true; si el proceso hijo ha sido parado por un señal.

Siempre definido a &false; bajo Windows.

</entry>

</row>

<row>

<entry>exitcode</entry>

<entry>&integer;</entry>

<entry>

El código retornado por el proceso (únicamente si el elemento

<literal>running</literal> vale &false;).

Antes de PHP 8.3.0, solo la primera llamada de esta función retornaba el verdadero valor, las llamadas siguientes retornaban <literal>-1</literal>.</entry>

</row>

<row>

<entry>en caché</entry>

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

<entry>

A partir de PHP 8.3.0, esto es &true; cuando el código de salida está en caché.

La caché es necesaria para asegurarse de que el código de salida no se pierde durante las llamadas siguientes a las API de procesamiento.

</entry>

</row>

<row>

<entry>termsig</entry>

<entry>&integer;</entry>

<entry>

el número del señal que ha causado la terminación de la ejecución del proceso hijo

(únicamente significativo si <literal>signaled</literal> vale &true;).

</entry>

</row>

<row>

<entry>stopsig</entry>

<entry>&integer;</entry>

<entry>

el número del señal que ha causado la parada de la ejecución del proceso hijo

(únicamente significativo si <literal>signaled</literal> vale &true;).

</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>

La entrada <literal>"en caché"</literal> ha sido añadida al array retornado.

Antes de PHP 8.3.0, solo la primera llamada retornaba el verdadero código de salida.

La entrada <literal>"en caché"</literal> indica que el código de salida ha sido puesto en caché.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

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

</simplelist>

</para>

</refsect1>

</refentry>