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

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

  • usleep() - Задерживает выполнение в микросекундах
  • time_nanosleep() - Задержка на заданное число секунд и наносекунд
  • time_sleep_until() - Откладывает исполнение скрипта до заданного времени
  • set_time_limit() - Ограничивает время выполнения скрипта