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 (значение константы Windows API WAIT_IO_COMPLETION). На других платформах возвращаемом значением будет количество секунд, оставшихся до задержки.

Ошибки

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

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

Версия Описание
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() - Ограничение времени выполнения скрипта