(PHP 5, PHP 7, PHP 8)
proc_get_status — Obtem informação sobre um processo aberto por proc_open()
proc_get_status() obtém dados sobre um processo aberto usando proc_open().
Um array com a informação coletada. O array retornado contém os seguintes elementos:
elemento | type | descriçã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 )
|
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.
|