array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.sleep.php', 1 => 'sleep', 2 => 'Verzögert die Programmausführung', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Sonstige Funktionen', ), 'prev' => array ( 0 => 'function.show-source.php', 1 => 'show_source', ), 'next' => array ( 0 => 'function.sys-getloadavg.php', 1 => 'sys_getloadavg', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/misc/functions/sleep.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sleep

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

sleep — Verzögert die Programmausführung

Beschreibung

sleep(int $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ür 0 Sekunden.

Parameter-Liste

seconds

Die Verzögerung in Sekunden (muss größer oder gleich 0 sein).

Rückgabewerte

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.

Fehler/Exceptions

Falls die angegebene Anzahl von Sekunden negativ ist, löst diese Funktion einen ValueError aus.

Changelog

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.

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