(PHP 4, PHP 5, PHP 7, PHP 8)
sleep — Verzögert die Programmausführung
Verzögert die weitere Skript-Ausführung für die angegebene Anzahl von
Sekunden
.
Hinweis:
Um die Programmausführung für einen Bruchteil einer Sekunde zu verzögern, muss die Funktion usleep() verwendet werden, da sleep() einen Integer erwartet. Zum Beispiel unterbricht
sleep(0.25)
die Programmausführung für0
Sekunden.
seconds
Die Verzögerung in Sekunden (muss größer oder gleich
0
sein).
Gibt bei Erfolg Null zurück.
Wenn der Aufruf durch ein Signal unterbrochen wurde, gibt
sleep() eine positive Zahl zurück. Auf Windows ist
dieser Wert immer 192
(der Wert der
WAIT_IO_COMPLETION
Konstanten der Windows API). Auf
anderen Plattformen ist der Rückgabewert die Anzahl der Sekunden die das
Programm eigentlich noch "schlafen" sollte.
Falls die angegebene Anzahl von Sekunden
negativ
ist, löst diese Funktion einen ValueError aus.
Version | Beschreibung |
---|---|
8.0.0 |
Die Funktion löst bei negativem seconds einen
ValueError aus; vorher wurde stattdessen ein
Fehler der Stufe E_WARNING ausgelöst, und die
Funktion gab false zurück.
|
Beispiel #1 sleep()-Beispiel
<?php
// die aktuelle Zeit
echo date('h:i:s') . "\n";
// 10 Sekunden schlafen
sleep(10);
// aufwachen!
echo date('h:i:s') . "\n";
?>
Dieses Beispiel erzeugt nach zehn Sekunden die Ausgabe.
05:31:23 05:31:33