Получает информацию о процессе, который открыли функцией proc_open

# proc_get_status

(PHP 5, PHP 7, PHP 8)

proc_get_status — Получает информацию о процессе, который открыли функцией proc_open()

### Описание

function proc_get_status(resource `$process`): array

Функция proc_get_status() получает данные о процессе, который открыли через функцию proc_open().

### Список параметров

`process`

  Дескриптор типа resource, который открыли функцией proc_open() и который исследует функция.

### Возвращаемые значения

Функция возвращает массив (array) с полученной информацией. Получаемый массив содержит следующие элементы:

элемент | тип | описание
--- | --- | ---
command | string | Строка с командой, которую передали в функцию proc_open().
pid | int | идентификатор процесса
running | bool | Значение элемента равняется `true`, если процесс всё ещё запущен, `false`, если процесс завершился.
signaled | bool | Значение элемента равняется `true`, если дочерний процесс завершился неперехваченным сигналом. В Windows независимо от условия завершения дочернего процесса значение элемента равняется `false`.
stopped | bool | Значение элемента равняется `true`, если дочерний процесс остановился сигналом. В Windows независимо от условия остановки дочернего процесса значение элемента равняется `false`.
exitcode | int | Код завершения, который возвращается процессом и который несёт смысл, только если значение элемента `running` равно `false`. До PHP 8.3.0 только первый вызов функции возвращал реальное значение, очередные вызовы возвращали значение `-1`.
cached | bool | С PHP 8.3.0 значение элемента равно `true`, когда код завершения закешировался. Кеширование гарантирует, что код завершения не потеряется при очередных вызовах к API-интерфейсу процесса.
termsig | int | Номер сигнала, который заставил дочерний процесс завершить выполнение и который несёт смысл, только если значение элемента `signaled` равно `true`.
stopsig | int | Номер сигнала, который заставил дочерний процесс остановить выполнение и который несёт смысле, только если значение элемента `stopped` равно `true`.

### Список изменений

Версия | Описание
--- | ---
8.3.0 | В массив возврата добавили запись `"cached"`. До PHP 8.3.0 только первый вызов возвращал реальной код завершения. Запись `"cached"` указывает на то, что код завершения закешировался.

### Смотрите также

- proc_open() - Выполняет команду и открывает указатель на файл для ввода или вывода

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