Obtem informação sobre um processo aberto por proc_open

# proc_get_status

(PHP 5, PHP 7, PHP 8)

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

### Descrição

function 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:

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`)

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

- proc_open() - Executa um comando e abre ponteiros de arquivo para entrada/saída

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open