pcntl_waitpid

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

pcntl_waitpid — Attend la fin de l'exécution d'un processus fils

Description

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

Suspend l'exécution du processus courant jusqu'à ce qu'un processus fils spécifié par le paramètre process_id ait terminé, qu'un signal ait mis fin à ce processus ou qu'un signal ait appelé un gestionnaire de signaux.

Si le processus fils identifié par process_id est déjà terminé au moment de l'appel de cette fonction (on les appelle des processus "zombie"), la fonction se termine immédiatement. Toute ressource système utilisée par le processus fils est libérée. Se reporter à la page de man waitpid(2) pour avoir des détails sur le comportement de cette fonction sur le système.

Liste de paramètres

process_id

La valeur de process_id peut être une parmi les suivantes :

**Valeurs possibles pour `process_id`**
`< -1`	attend un processus fils dont l'identifiant de groupe est égal à la valeur absolue de `process_id`.
`-1`	attend tout processus fils ; cela correspond au même comportement que celui de la fonction pcntl_wait() présente.
`0`	attend un processus fils dont l'identifiant de groupe est égal à celui du processus courant.
`> 0`	attend le processus fils dont l'identifiant est égal à la valeur de `process_id`.

Note:
Si process_id vaut -1, cela équivaut à utiliser la fonction pcntl_wait() (moins flags).

status

pcntl_waitpid() enregistrera des informations sur le statut courant du processus dans le paramètre status, auquel on peut accéder grâce aux fonctions suivantes : pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() et pcntl_wstopsig().

flags

Le paramètre flags peut prendre la valeur zéro, ou plusieurs des constantes globales suivantes (combinez les avec l'opérateur OR) :

**Valeurs possibles de `flags`**
`WNOHANG`	retourne immédiatement si aucun processus fils ne s'est terminé.
`WUNTRACED`	retourne lorsque les processus fils sont arrêtés et que leur statut n'a pas été mis à jour.

resource_usage

Le paramètre resource_usage est défini sur un array associatif contenant les statistiques d'utilisation des ressources du processus enfant. Pour le détail de son contenu, voir getrusage().

Ceci n'est pris en charge que si l'appel système wait4(2) est disponible sur le système ; sinon, le paramètre est laissé inchangé. Si aucun processus enfant n'a été récolté, c'est-à-dire si la fonction retourne 0 ou -1, le paramètre est défini sur un array vide.

Valeurs de retour

pcntl_waitpid() retourne l'identifiant de processus du processus fils qui s'est terminé, ou bien -1 en cas d'erreur ou encore zéro si WNOHANG a été utilisée et qu'aucun processus fils n'était disponible.

Exemples

Exemple #1 Exemple avec pcntl_waitpid()

<?php
function checkChild(int $pid, bool $wait): void
{
    $flags = ($wait ? 0 : WNOHANG);
    $deadPid = pcntl_waitpid($pid, $status, $flags, $rusage);
    if ($deadPid === -1) {
        $errNo = pcntl_get_last_error();
        $errMsg = pcntl_strerror($errNo);
        print "PARENT pcntl_waitpid FAILED ({$errNo}): {$errMsg}\n";
    } elseif ($deadPid === 0) {
        print "PARENT pcntl_waitpid: No exited children.\n";
    } elseif (pcntl_wifexited($status)) {
        print "PARENT pcntl_waitpid: Child PID {$deadPid} exited with status: "
            . pcntl_wexitstatus($status) . "\n";
        var_dump($rusage);
    } else {
        print "PARENT pcntl_waitpid: Child PID {$deadPid} was terminated by signal: "
            . pcntl_wtermsig($status) . "\n";
    }
}

$parentPid = getmypid();
$forkedPid = pcntl_fork();
if ($forkedPid == -1) {
    die('Could not fork');
} else if ($forkedPid) {
    // Processus parent
    print "PARENT {$parentPid} has forked {$forkedPid}\n";

    print "PARENT is checking for exited children\n";
    checkChild($forkedPid, false);

    // Empêche les enfants de rester en "processus zombie"
    print "PARENT is waiting for a child to exit\n";
    checkChild($forkedPid, true);

    print "PARENT is checking for exited children\n";
    checkChild($forkedPid, false);

    print "PARENT is exiting\n";
} else {
    // Processus enfant
    $pid = getmypid();
    print "CHILD {$pid} is sleeping\n";
    sleep(10);
    print "CHILD is exiting\n";
    exit(7);
}

Voir aussi

pcntl_fork() - Duplique le processus courant
pcntl_signal() - Installe un gestionnaire de signaux
pcntl_wait() - Attend ou retourne le statut d'un processus fils
pcntl_wifexited() - Vérifie si le code de retour représente une fin normale
pcntl_wifstopped() - Retourne true si le processus fils est stoppé
pcntl_wifsignaled() - Retourne true si le code statut représente une fin due à un signal
pcntl_wexitstatus() - Retourne le code d'un processus fils terminé
pcntl_wtermsig() - Retourne le signal qui a provoqué la fin du processus fils
pcntl_wstopsig() - Retourne le signal qui a causé l'arrêt du processus fils

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

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.

down

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);
}
?>

down

-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);
        }
    }
}
?>

＋add a note