sleep
(PHP 4, PHP 5, PHP 7, PHP 8)
sleep — Verzögert die Programmausführung
Beschreibung
$seconds): int
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ür0Sekunden.
Parameter-Liste
-
seconds -
Die Verzögerung in Sekunden.
Rückgabewerte
Gibt bei Erfolg Null zurück oder im Fehlerfall false.
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.
Fehler/Exceptions
Falls die angegebene Anzahl von Sekunden negativ
ist, erzeugt diese Funktion einen Fehler des Typs
E_WARNING.
Beispiele
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
Siehe auch
- usleep() - Verzögert die Programmausführung (in Mikrosekunden)
- time_nanosleep() - Verzögert die Ausführung um die gegebene Anzahl Sekunden und Nanosekunden
- time_sleep_until() - Lässt das Skript bis zur angegebenen Zeit schlafen
- set_time_limit() - Beschränkt die maximale Ausführungszeit
