array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.proc-get-status.php', 1 => 'proc_get_status', 2 => 'Получает информацию о процессе, который открыли функцией proc_open', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Функции запуска программ', ), 'prev' => array ( 0 => 'function.proc-close.php', 1 => 'proc_close', ), 'next' => array ( 0 => 'function.proc-nice.php', 1 => 'proc_nice', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/exec/functions/proc-get-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

proc_get_status

(PHP 5, PHP 7, PHP 8)

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

Описание

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" указывает на то, что код завершения закешировался.

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