sleep
(PHP 4, PHP 5)
sleep — Retrasar la ejecución
Descripción
$seconds
)
Retrasa la ejecución del programa durante el número de segundos dados por
seconds.
Parámetros
-
seconds -
El tiempo de parada en segundos.
Valores devueltos
Devuelve cero en caso de éxito, o FALSE en caso de error.
Si la llamada se interrumpió por una señal, sleep() devuelve
un valor distinto de cero. En Windows, este valor será siempre
192 (el valor de la constante
WAIT_IO_COMPLETION dentro de la API de Windows).
En otras plataformas, el valor devuelto será el número de segundos que quedan para
dormir.
Errores/Excepciones
Si el número de segundos especificado por seconds es negativo,
esta función generará un error de nivel E_WARNING.
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.3.4 |
Antes de PHP 5.3.4, en Windows, sleep() siempre
devuelve NULL cuando el sueño ha sucedido, si tener en cuenta si el
sueño fue interrumpido o no.
|
Ejemplos
Ejemplo #1 Ejemplo de sleep()
<?php
// hora actual
echo date('h:i:s') . "\n";
// dormir durante 10 segundos
sleep(10);
// ¡despierta!
echo date('h:i:s') . "\n";
?>
Este ejemplo imprimirá (después de 10 segundos)
05:31:23 05:31:33
Ver también
- usleep() - Retrasar la ejecución en microsegundos
- time_nanosleep() - Retrasar por un número de segundos y nanosegundos
- time_sleep_until() - Hacer que el script duerma hasta el momento especificado
- set_time_limit() - Limita el tiempo máximo de ejecución