(PHP 5, PHP 7, PHP 8)
proc_get_status — Получает информацию о процессе, который открыли функцией proc_open()
Функция 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" указывает на то, что код завершения
закешировался.
|