array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.proc-get-status.php', 1 => 'proc_get_status', 2 => 'Obtem informação sobre um processo aberto por proc_open', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Funções para Execução de programas', ), 'prev' => array ( 0 => 'function.proc-close.php', 1 => 'proc_close', ), 'next' => array ( 0 => 'function.proc-nice.php', 1 => 'proc_nice', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/exec/functions/proc-get-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_status — Obtem informação sobre um processo aberto por proc_open()

Descrição

proc_get_status(resource $process): array

proc_get_status() obtém dados sobre um processo aberto usando proc_open().

Parâmetros

process

O recurso to tipo resource gerado por proc_open() que será avaliado.

Valor Retornado

Um array com a informação coletada. O array retornado contém os seguintes elementos:

elementotypedescrição
command string A string de comando que foi passada para proc_open().
pid int Id do processo
running bool true se o processo ainda está sendo executado, false se ele terminou.
signaled bool true se o processo filho terminou por um sinal não capturado. Sempre definido como false no Windows.
stopped bool true se o processo filho foi parado por um sinal. Sempre definido como false no Windows.
exitcode int O código de saída retornado pelo processo (que é significativo somente se running for false). Antes do PHP 8.3.0, apenas a primeira chamada a esta função retornava o valor real, a chamada seguinte retornava -1.
cached bool A partir do PHP 8.3.0, isto é true quando o código de saída está em cache. O cache é necessário para garantir que o código de saída não é perdido por chamadas subsequentes a APIs de processos.
termsig int O número do sinal que fez o processo filho terminar a sua execução (somente significativo se signaled for true)
stopsig int O número do sinal que fez o processo filho terminar a sua execução (somente significativo se stopped for true)

Registro de Alterações

Versão Descrição
8.3.0 A entrada "cached" foi adicionada ao array retornado. Antes do PHP 8.3.0, apenas a primeira chamada retornava o código de saída real. A entrada "cached" indica que o código de saída foi armazenado em cache.

Veja Também