ScotlandPHP

pcntl_waitpid

(PHP 4 >= 4.1.0, PHP 5, PHP 7)

pcntl_waitpidОжидает или возвращает статус порожденного дочернего процесса

Описание

int pcntl_waitpid ( int $pid , int &$status [, int $options = 0 ] )

Функция ожидания приостанавливает выполнение текущего процесса до тех пор, пока дочерний процесс, указанный в аргументе pid, не завершится или пока не будет получен сигнал который завершает текущий процесс или вызывает функцию обработки сигнала.

Если дочений процесс, указанный в аргументе pid, уже завершился ко времени вызова (так называемые "зомби" процессы), функция незамедлительно вернёт управление. Любые системные ресурсы используемые дочерним процессом будут освобождены. Обратитесь к вашей системному рукодводству (man) waitpid(2) для уточнения специфики работы waitpid в вашей системе.

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

pid

Аргумент pid может принимать одно из следующих значений:

возможные значения аргумента pid
< -1 ожидать любой дочерний процесс, у которого значение идентификатор группы процессов (group ID) равно модулую значения аргумента |pid|.
-1 ожидать любой дочерний процесс; это такое же поведение, что и у функции wait.
0 ожидать любой дочерний процесс, идентификатор группы процессов (group ID) которого равен идентификатору текущего процесса.
> 0 ожидать дочерний процесс ID которого равен pid.

Замечание:

Указание -1 в качестве pid - это аналог функции pcntl_wait() (минус options).

status

pcntl_waitpid() разместит информацию о статусе по ссылке в аргументе status, который может быть передан в слудующие функции: pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() и pcntl_wstopsig().

options

Значение аргумента options - это битовая маска, которая может принимать значение ноль или более путем логического объединения следующих констант:

Возможные значения для options
WNOHANG Незамедлительно вернуть управление, если ни один из дочерних процессов не завершен
WUNTRACED Вернуть управление для остановленных дочерних процессов, о статусе которых ещё не сообщено

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

pcntl_wait() возвращает ID завершенного дочернего процесса, -1 при ошибке или ноль, если WNOHANG был передан в аргумент options и не было доступных дочерних процессов.

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

  • pcntl_fork() - Разветвить (fork) текущий запущенный процесс
  • pcntl_signal() - Установка обработчика сигнала
  • pcntl_wifexited() - Проверяет, соответствует ли код завершения процесса нормальныму завершению
  • pcntl_wifstopped() - Проверить, остановлен ли дочерний процесс
  • pcntl_wifsignaled() - Проверить, соответствует ли код завершения процесса завершению по сигналу
  • pcntl_wexitstatus() - Получить код возврата завершенного дочернего процесса
  • pcntl_wtermsig() - Получить сигнал, из-за которого был принудительно завершен дочерний процесс
  • pcntl_wstopsig() - Получить сигнал, из-за которого был остановлен дочерний процесс

add a note add a note

User Contributed Notes 2 notes

up
1
fx4084 at gmail dot com
3 years ago
<?php
$childs
= array();

// Fork some process.
for($i = 0; $i < 10; $i++) {
   
$pid = pcntl_fork();
    if(
$pid == -1)
        die(
'Could not fork');

    if (
$pid) {
        echo
"parent \n";
       
$childs[] = $pid;
    } else {
       
// Sleep $i+1 (s). The child process can get this parameters($i).
       
sleep($i+1);
       
       
// The child process needed to end the loop.
       
exit();
    }
}

while(
count($childs) > 0) {
    foreach(
$childs as $key => $pid) {
       
$res = pcntl_waitpid($pid, $status, WNOHANG);
       
       
// If the process has already exited
       
if($res == -1 || $res > 0)
            unset(
$childs[$key]);
    }
   
   
sleep(1);
}
?>
up
-1
saguto dot l7cc at gmail dot com
9 years ago
please note, if you using configure option --enable-sigchild(Enable PHP's own SIGCHLD handler) when complie php(under linux 2.6.18-53.1.13.el5.centos.plus and php 5.2.5 as I know), pcntl_waitpid and pcntl_wait in php script would never return the child pid, because the build in handle get it first.
To Top