sleep

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

sleepArrête l'exécution durant quelques secondes

Description

sleep(int $seconds): int

Arrête l'exécution du programme pendant seconds secondes.

Note:

Afin de retarder l'exécution d'un programme pendant une fraction de seconde, utilisez la fonction usleep() car la fonction sleep() attend un entier. Par exemple, sleep(0.25) retardera l'exécution du programme pendant 0 seconde.

Liste de paramètres

seconds

Le temps d'arret, en nombre de secondes (doit être supérieur ou égal à 0).

Valeurs de retour

Retourne zéro en cas de succès.

Si l'appel est interrompu par un signal, la fonction sleep() retournera une valeur différente de zéro. Sous Windows, la valeur sera toujours de 192 (la valeur de la constante WAIT_IO_COMPLETION de l'API Windows). Sous les autres plateformes, la valeur retournée sera le nombre de secondes restantes à la fonction sleep().

Erreurs / Exceptions

Une ValueError est lancée si le nombre seconds spécifié est négatif.

Historique

Version Description
8.0.0 La fonction lance une ValueError si seconds est négatif; auparavant, une erreur de niveau E_WARNING était levée, et la fonction retournait false.

Exemples

Exemple #1 Exemple avec sleep()

<?php

// Heure actuelle
echo date('h:i:s') . "\n";

// Stoppe pour 10 secondes
sleep(10);

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

?>

Cet exemple affichera (après 10 secondes) :

05:31:23
05:31:33

Voir aussi