Please note that the callback function never gets called when the stream is (at least) of type socket. It is probably the same for the file:// proto although I've not done further tests.
I'm using php 5.3.3.
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
int
?string
int
int
int
): void
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_transferredsera rempli. -
bytes_max -
Si c'est possible,
bytes_maxsera 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);
/* Ignore */
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:
/* Ignore */
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)
add a note
User Contributed Notes 3 notes
recycling dot sp dot am at gmail dot com ¶
14 years ago
billynoah at gmail dot com ¶
7 years ago
A couple of notes regarding the examples here (I'm using PHP 7.0.18):
1) fopen() did not provide STREAM_NOTIFY_PROGRESS for me but `file_get_contents()` worked fine.
2) The bytes transferred when transferring a zip file seems to always be shy by 8192 (8k). This varies depending on filetype and also breaks STREAM_NOTIFY_PROGRESS when the filesize is below 8k. I modified the function and it's now displaying the correct amount transferred and percentage downloaded on zip files above 8k. I'm not sure why the callback is so inconsistent but hopefully this is helpful to someone. This was also modified to only display progress:
<?php
$ctx = stream_context_create();
stream_context_set_params($ctx, array("notification" => "stream_notification_callback"));
$fileData = @file_get_contents('http://example.com/test.zip',false,$ctx);
function stream_notification_callback($notification_code, $severity, $message, $message_code, $bytes_transferred, $bytes_max) {
static $filesize = null;
switch($notification_code) {
case STREAM_NOTIFY_FILE_SIZE_IS:
$filesize = $bytes_max;
break;
case STREAM_NOTIFY_CONNECT:
echo "Connected...\n";
break;
case STREAM_NOTIFY_PROGRESS:
if ($bytes_transferred > 0 && $filesize >= 8192) {
$bytes_transferred += 8192;
if (!isset($filesize)) {
printf("\rUnknown filesize.. %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;
}
}
?>
aetonsi ¶
2 years ago
A couple of unreported behaviors:
- case 1) if this callback calls die/exit($msg), it will print $msg, then the execution will go on until the request/wrapper is consumed, emitting a "PHP Warning: Failed to call user notifier" on each invocation of the callback. After the last callback invocation, the script is immediately terminated.
- case 2) if this callback throws an exception, it will behave the same way as exit/die, except for the fact that after the last callback invocation it does not terminate the script. The exception is instead raised in the scope of the request/wrapper, and can be caught with a try catch (right there or at a higher level).
Example code for case 1). The final "TEST ECHO" string will NOT be printed.
<?php
$context = stream_context_create(['http' => ['ignore_errors' => true,]]);
stream_context_set_params($context, ['notification' => function () {
die('error');
}]);
file_get_contents('https://www.google.com', false, $context);
echo "TEST ECHO";
?>
Example code for case 2). The exception is raised at the level of the file_get_contents call, it's catched, and the final "TEST ECHO" gets printed.
<?php
$context = stream_context_create(['http' => ['ignore_errors' => true,]]);
stream_context_set_params($context, ['notification' => function () {
throw new Exception('...');
}]);
try{
file_get_contents('https://www.google.com', false, $context);
}catch(exception $e) { }
echo "TEST ECHO";
?>
