Le watcher EvPeriodic fonctionne en différents
modes suivant les paramètres offset
,
interval
et reschedule_cb
.
Le mode Minuterie absolue. Dans ce mode,
interval
= 0
,
reschedule_cb
= null
.
L'appel se fera à l'heure d'horloge offset
et ne sera pas répété. Il ne sera pas ajusté lorsqu'un bon dans le temps
surviendra, aussi, s'il doit être exécuté à
January 1st 2014, alors il le sera lorsque l'heure
système sera atteinte, ou dépassée.
Le mode Minuterie avec répétition par intervalle.
Dans ce mode, interval
> 0
,
reschedule_cb
= null
; le watcher sera automatiquement
programmé pour se terminer à la prochaine durée
offset
+ N
* interval
(pour un entier N
) puis, se répète, indépendamment des sauts
dans le temps.
Il peut être utilisé pour créer des minuteries qui ne dérivent pas en respectant l'horloge système :
<?php
$hourly = EvPeriodic(0, 3600, NULL, function () {
echo "une fois par heure\n";
});
?>
3600
secondes
entre chaque appel, mais seulement que la fonction de rappel sera appelée
lorsque l'horloge système affichera une heure pleine (UTC).
La classe EvPeriodic va tenter d'exécuter la fonction
de rappel dans ce mode à la prochaine heure possible où
time = offset
(mod
interval
), indépendamment des sauts dans le temps.
Le mode reprogrammation manuelle. Dans ce mode,
reschedule_cb
est un callable.
interval
et offset
seront tous les deux ignorés. A la place, chaque fois que le watcher périodique
est prévue, la fonction de rappel de reprogrammation (reschedule_cb
)
sera appelée avec le watcher d'abord, et le temps courant comme second argument.
Cette fonction de rappel ne doit pas stopper ou détruire
ce watcher périodique, ni un autre, et ne doit pas
appeler de fonctions ou de méthodes de boucle d'événements. Pour le stopper,
retournez 1e30
et stoppez le après. Un watcher
EvPrepare peut être utilisé pour réaliser cette tâche.
Il doit retourner la prochaine heure d'appel, en se basant sur la valeur du temps passé (la plus petite valeur de temps doit être supérieure ou égale au second argument). Il sera appelée, habituellement, juste après que la fonction de rappel ne soit lancée, mais possiblement à d'autres moments.
Exemple #1 Using reschedule callback
<?php
// Chaque 10.5 secondes
function reschedule_cb ($watcher, $now) {
return $now + (10.5. - fmod($now, 10.5));
}
$w = new EvPeriodic(0., 0., "reschedule_cb", function ($w, $revents) {
echo time(), PHP_EOL;
});
Ev::run();
?>