sleep

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

sleep — Atrasa a execução

Descrição

sleep(int $seconds): int

Atrasa a execução do programa pelo número de segundos informado no parâmetro seconds.

Note:

Para atrasar a execução do programa por uma fração de um segundo, use a função usleep() pois a função sleep() espera um número int. Por exemplo sleep(0.25) irá pausar a execução do programa por 0 segundo.

Parâmetros

seconds

Tempo de parada em segundos (deve ser maior ou igual a 0).

Valor Retornado

Retorna zero em caso de sucesso.

Se a chamada foi interrompida por um sinal, a função sleep() retorna um valor não-zero. No Windows, este valor será sempre 192 (o valor da constante WAIT_IO_COMPLETION dentro da API do Windows). Em outras plataformas, o valor de retorno será o número de segundos que faltam para terminar a parada.

Erros/Exceções

Se o número de segundos especificado em seconds for negativo, esta função irá lançar um ValueError.

Registro de Alterações

Versão Descrição
8.0.0 A função lança um ValueError para valores negativos de seconds; anteriormente, um E_WARNING era emitido, e a função retornava false.

Exemplos

Example #1 Exemplo de sleep()

<?php

// horário atual
echo date('h:i:s') . "\n";

// dorme por 10 seconds
sleep(10);

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

?>

Este exemplo irá mostrar (depois de 10 segundos) 

05:31:23
05:31:33

Veja Também