LonghornPHP 2026

pcntl_waitpid

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

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

Описание

function pcntl_waitpid(
int $process_id,
int &$status,
int $flags = 0,
array &$resource_usage = []
): int

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

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

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

process_id

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

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

Замечание:

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

status

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

flags

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

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

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

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

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

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

Нашли ошибку?

ИнструкцияИсправлениеСообщение об ошибке
+Добавить

Примечания пользователей 3 notes

up
3
saguto dot l7cc at gmail dot com
18 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.
up
0
fx4084 at gmail dot com
11 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
renmengyang567 at gmail dot com
7 years ago
<?php
declare(ticks = 1);
function zp_handler($signal) {
 $id = pcntl_waitpid(-1, $status, WNOHANG);
 if (pcntl_wifexited($status)) 
 {
 printf("Removed Chlid id: %d \n",$id);
 printf("Chlid status: %d \n",pcntl_wexitstatus($status));
 }
}
//pcntl_signal_dispatch();
pcntl_signal(SIGCHLD, "zp_handler");
//pcntl_signal_dispatch();
//
$pid = pcntl_fork();
if ($pid == 0)
{
 print "#1 Hi, I'm child process".PHP_EOL;
 sleep(3);
 return 10;
}
else 
{
 print "#1parent process id:".$pid.PHP_EOL;
 $pid = pcntl_fork();
 if ($pid == 0)
 { print "#2 Hi, I'm child process".PHP_EOL;
 sleep(10);
 exit(20);
 } 
 else 
 {
 print "#2parent process id:".$pid.PHP_EOL;
 for ($i=0; $i <10 ; $i++) { 
 print "wait..".PHP_EOL;
 sleep(10);
 }
 }
}
?>
+Добавить

AltStyle によって変換されたページ (->オリジナル) /