(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.
|