sleep

(PHP 4, PHP 5, PHP 7, PHP 8)

sleep — Detiene la ejecución durante algunos segundos

Descripción

sleep(int $seconds): int

Detiene la ejecución del programa durante seconds segundos.

Nota:
Para retrasar la ejecución de un programa durante una fracción de segundo, utilice la función usleep() ya que la función sleep() espera un int. Por ejemplo, sleep(0.25) retrasará la ejecución del programa durante 0 segundos.

Parámetros

seconds: El tiempo de detención, en número de segundos (debe ser superior o igual a 0).

Valores devueltos

Retorna cero en caso de éxito.

Si la llamada es interrumpida por una señal, la función sleep() retornará un valor diferente de cero. En Windows, el valor será siempre 192 (el valor de la constante WAIT_IO_COMPLETION de la API de Windows). En otras plataformas, el valor retornado será el número de segundos restantes para la función sleep().

Errores/Excepciones

Se lanza una ValueError si el número seconds especificado es negativo.

Historial de cambios

Versión	Descripción
8.0.0	La función lanza una ValueError si `seconds` es negativo; anteriormente, se generaba un error de nivel `E_WARNING` y la función retornaba `false`.

Ejemplos

Ejemplo #1 Ejemplo con sleep()

<?php

// Hora actual
echo date('h:i:s') . "\n";

// Detiene por 10 segundos
sleep(10);

// ¡Regreso!
echo date('h:i:s') . "\n";

?>

Este ejemplo mostrará (después de 10 segundos):

05:31:23
05:31:33

Ver también

usleep() - Detiene la ejecución durante algunas microsegundos
time_nanosleep() - Esperar durante un número de segundos y nanosegundos
time_sleep_until() - Detiene el script durante una duración especificada
set_time_limit() - Establece el tiempo máximo de ejecución de un script