uniqid> <time_nanosleep
Last updated: Fri, 03 Feb 2012

time_sleep_until

(PHP 5 >= 5.1.0)

time_sleep_until Paralisa o script até um tempo especificado

Descrição

bool time_sleep_until ( float $timestamp )

Paralisa o script até o especificado timestamp.

Parâmetros

timestamp

O timestamp quando o script deve voltar.

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em falhas.

Erros

Se o especificado timestamp é do passado, esta função irá gerar um E_WARNING.

Exemplos

Exemplo #1 Um exemplo da time_sleep_until()

<?php

//returns false and generates a warning
var_dump(time_sleep_until(time()-1));

// may only work on faster computers, will sleep up to 0.2 seconds
var_dump(time_sleep_until(time()+0.2));

?>

Notas

Nota: Todos sinais serão enviados depois do script voltar.

Nota: esta função não é implementada na plataforma Windows

Veja Também

  • sleep() - Atrasa a execução do script
  • usleep() - Atrasa a execução em milionésimos de segundo
  • time_nanosleep() - Atrasa para um número de segundos e nanosegundos



uniqid> <time_nanosleep
Last updated: Fri, 03 Feb 2012
 
User Contributed Notes
time_sleep_until
purdue at nc dot rr dot com
05-May-2011 08:04
At least on my Windows machine, the time_sleep_until function appears to calculate the number of microseconds between now and the sleep-until timestamp, and it appears to use unsigned 32-bit math in this calculation.  This roundoff leads to a maximum sleep time of just under 4295 seconds (1 hour, 11 minutes, 35 seconds).  To get longer sleep times, while still using time_sleep_until to minimize processor overhead, the following loop may be some help to you:

<?php

$sleepuntil
= strtotime("tuesday 3pm");

while (
time() < $sleepuntil)
  
time_sleep_until($sleepuntil);

// proceed with dated processing

?>

Of course, one could use something like "cron" instead, to avoid the script doing the extended sleep.  Also note that time_nanosleep appears to do similar math, but it is somewhat more intuitive that the seconds parameter has an upper limit on what it can be.  Still, both functions might report a warning when waking up prematurely due to roundoff.
f dot schima at ccgmbh dot de
15-Feb-2010 07:32
Remember when using usleep() as a replacement for time_sleep_until() that usleep() can be interrupted by signals, time_sleep_until() not.
pasha
03-Sep-2009 03:11
To ensure that usleep() is called with the same argument as the one being tested - a positive number:

<?php
if (!function_exists('time_sleep_until')) {
   function
time_sleep_until($future) {
      
$sleep = ($future - microtime(1))*1000000;
       if (
$sleep<=0) {
          
trigger_error("Time in past", E_USER_WARNING);
           return
false;
       }

      
usleep($sleep);
       return
true;
   }
}
?>
roberto at spadim dot com dot br
16-Dec-2006 05:05
better implementation
<?php
if (!function_exists('time_sleep_until')) {
   function
time_sleep_until($future) {
       if (
$future < time()) {
          
trigger_error("Time in past", E_USER_WARNING);
           return
false;
       }

      
usleep(($future - microtime(1))*1000000);
       return
true;
   }
}
?>
ssnoyes at hotmail dot com
25-Nov-2005 09:58
Implementation for < 5.1 or Windows users

<?php
if (!function_exists('time_sleep_until')) {
    function
time_sleep_until($future) {
        if (
$future < time()) {
           
trigger_error("Time in past", E_USER_WARNING);
            return
false;
        }

       
sleep($future - time());
        return
true;
    }
}
?>

uniqid> <time_nanosleep
Last updated: Fri, 03 Feb 2012