stream_notification_callback

    (PHP 5 >= 5.2.0, PHP 7, PHP 8)

    stream_notification_callback — Une fonction de rappel pour le paramètre de contexte notification

    Description

    stream_notification_callback(
        int$notification_code,
        int$severity,
        ?string$message,
        int$message_code,
        int$bytes_transferred,
        int$bytes_max
    ): void

    Une fonction de rappel de type callable, utilisée par le paramètre de contexte notification, appelé lors d'un événement.

    Note:

    Ce n'est pas une réelle fonction, uniquement un prototype de la façon dont la fonction doit être.

    Liste de paramètres

    notification_code

    Une des constantes de notification STREAM_NOTIFY_*.

    severity

    Une des constantes de notification STREAM_NOTIFY_SEVERITY_*.

    message

    Passé si un message descriptif est disponible pour cet événement.

    message_code

    Passé si un code de message descriptif est disponible pour cet événement.

    La signification de cette valeur dépend du gestionnaire spécifique utilisé.

    bytes_transferred

    Si c'est possible, bytes_transferred sera rempli.

    bytes_max

    Si c'est possible, bytes_max sera rempli.

    Valeurs de retour

    Aucune valeur n'est retournée.

    Exemples

    Exemple #1 Exemple avec stream_notification_callback()

    <?php
    function stream_notification_callback($notification_code, $severity, $message, $message_code, $bytes_transferred, $bytes_max) {

    switch(    $notification_code) {
    case     STREAM_NOTIFY_RESOLVE:
    case     STREAM_NOTIFY_AUTH_REQUIRED:
    case     STREAM_NOTIFY_COMPLETED:
    case     STREAM_NOTIFY_FAILURE:
    case     STREAM_NOTIFY_AUTH_RESULT:
    var_dump($notification_code, $severity, $message, $message_code, $bytes_transferred, $bytes_max);

    break;

    case     STREAM_NOTIFY_REDIRECTED:
    echo     "Redirection vers : ", $message;
    break;

    case     STREAM_NOTIFY_CONNECT:
    echo     "Connecté...";
    break;

    case     STREAM_NOTIFY_FILE_SIZE_IS:
    echo     "Récupération de la taille du fichier : ", $bytes_max;
    break;

    case     STREAM_NOTIFY_MIME_TYPE_IS:
    echo     "Type mime trouvé : ", $message;
    break;

    case     STREAM_NOTIFY_PROGRESS:
    echo     "En cours de téléchargement, déjà ", $bytes_transferred, " octets transférés";
    break;
    }
    echo     "\n";
    }

    $ctx = stream_context_create();
    stream_context_set_params($ctx, array("notification" => "stream_notification_callback"));

    file_get_contents("http://php.net/contact", false, $ctx);
    ?>

    Résultat de l'exemple ci-dessus est similaire à :

    Connecté... Type mime trouvé : text/html; charset=utf-8 Redirection vers : http://no.php.net/contact Connecté... Récupération de la taille du fichier : 0 Type mime trouvé : text/html; charset=utf-8 Redirection vers : http://no.php.net/contact.php Connecté... Récupération de la taille du fichier : 4589 Type mime trouvé : text/html;charset=utf-8 En cours de téléchargement, déjà 0 octets transférés En cours de téléchargement, déjà 0 octets transférés En cours de téléchargement, déjà 0 octets transférés En cours de téléchargement, déjà 1440 octets transférés En cours de téléchargement, déjà 2880 octets transférés En cours de téléchargement, déjà 4320 octets transférés En cours de téléchargement, déjà 5760 octets transférés En cours de téléchargement, déjà 6381 octets transférés En cours de téléchargement, déjà 7002 octets transférés

    Exemple #2 Barre de progression simple pour un client de téléchargement en ligne de commande

    <?php
    function usage($argv) {
    echo     "Utilisation :\n";
    printf("\tphp %s <http://example.com/file> <localfile>\n", $argv[0]);
    exit(    1);
    }

    function     stream_notification_callback($notification_code, $severity, $message, $message_code, $bytes_transferred, $bytes_max) {
    static     $filesize = null;

    switch(    $notification_code) {
    case     STREAM_NOTIFY_RESOLVE:
    case     STREAM_NOTIFY_AUTH_REQUIRED:
    case     STREAM_NOTIFY_COMPLETED:
    case     STREAM_NOTIFY_FAILURE:
    case     STREAM_NOTIFY_AUTH_RESULT:

    break;

    case     STREAM_NOTIFY_REDIRECTED:
    echo     "Redirection vers : ", $message, "\n";
    break;

    case     STREAM_NOTIFY_CONNECT:
    echo     "Connecté...\n";
    break;

    case     STREAM_NOTIFY_FILE_SIZE_IS:
    $filesize = $bytes_max;
    echo     "Taille du fichier : ", $filesize, "\n";
    break;

    case     STREAM_NOTIFY_MIME_TYPE_IS:
    echo     "Type Mime : ", $message, "\n";
    break;

    case     STREAM_NOTIFY_PROGRESS:
    if (    $bytes_transferred > 0) {
    if (!isset(    $filesize)) {
    printf("\rTaille du fichier inconnue.. %2d kb done..", $bytes_transferred/1024);
    } else {
    $length = (int)(($bytes_transferred/$filesize)*100);
    printf("\r[%-100s] %d%% (%2d/%2d kb)", str_repeat("=", $length). ">", $length, ($bytes_transferred/1024), $filesize/1024);
    }
    }
    break;
    }
    }

    isset(    $argv[1], $argv[2]) or usage($argv);

    $ctx = stream_context_create();
    stream_context_set_params($ctx, array("notification" => "stream_notification_callback"));

    $fp = fopen($argv[1], "r", false, $ctx);
    if (    is_resource($fp) && file_put_contents($argv[2], $fp)) {
    echo     "\nFait !\n";
    exit(    0);
    }

    $err = error_get_last();
    echo     "\nErrrrreurr..\n", $err["message"], "\n";
    exit(    1);
    ?>

    Exécutez l'exemple ci-dessus avec : php -n fetch.php http://no2.php.net/get/php-5-LATEST.tar.bz2/from/this/mirror php-latest.tar.bz2 affichera quelque chose similaire à : 

    Connecté... Type Mime : text/html; charset=utf-8 Redirection vers : http://no2.php.net/distributions/php-5.2.5.tar.bz2 Connecté... Taille du fichier : 7773024 Type Mime : application/octet-stream [========================================> ] 40% (3076/7590 kb)
    To Top