array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.sleep.php', 1 => 'sleep', 2 => 'Задерживает выполнение', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Разные функции', ), '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' => 'ru', '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 — Задерживает выполнение

Описание

sleep(int $seconds): int

Функция откладывает исполнение программы на число секунд, которое указали в параметре seconds.

Замечание:

На доли секунды выполнение программы откладывают функцией usleep(), поскольку функция sleep() ожидает целое число (int). Например, вызов sleep(0.25) приостановит выполнение программы на 0 секунд.

Список параметров

seconds

Время остановки в секундах. Параметр принимает значения, которые больше или равны 0.

Возвращаемые значения

В случае успешного выполнения функция возвращает 0.

Функция sleep() вернёт значение, которое не равно нулю, если вызов прервал сигнал. В Windows это значение будет равно 192 — значение константы API-интерфейса Windows WAIT_IO_COMPLETION. На других платформах значением возврата будет количество секунд, которое осталось до задержки.

Ошибки

Функция выбрасывает исключение ValueError, если в параметр seconds передали отрицательное количество секунд.

Список изменений

Версия Описание
8.0.0 Функция выбрасывает исключение ValueError, если в параметре seconds указали отрицательное число; раньше вместо этого выдавалась ошибка уровня E_WARNING и функция возвращала значение false.

Примеры

Пример #1 Пример задержки выполнения программы функцией sleep()

<?php

// Текущее время
echo date('h:i:s') . "\n";

// Спим в течениe 10 секунд
sleep(10);

// Просыпаемся
echo date('h:i:s') . "\n";

?>

Через 10 секунд пример выведет: 

05:31:23
05:31:33

Смотрите также