PHP sleep() 函数

PHP 杂项函数

定义和用法

sleep() 函数将当前脚本的执行延迟指定的秒数。

注意：如果指定的秒数为负数，此函数将抛出一个错误。

提示：为了让程序执行延迟几分之一秒，应使用 usleep()，因为 sleep() 需要 int。例如 sleep(0.25) 会使程序暂停 0 秒。

实例

将当前脚本的执行延迟 3 秒：

<?php
echo date('h:i:s') . "<br>";

// 休眠 3 秒
sleep(3);

// 再次开始
echo date('h:i:s');
?>

亲自试一试

语法

sleep(seconds)
参数 描述
seconds 必需。指定要延迟脚本的秒数。

返回值

若成功，返回 0，否则返回 false。

错误／异常

如果指定的描述 seconds 是负数，该函数将生成一个 E_WARNING。

技术细节

返回值：

成功时返回 0。错误时返回 FALSE。

如果函数的调用被一个信号中止，sleep() 会返回一个非零的值。

在 Windows 上，该值总是 192（即 Windows API 常量 WAIT_IO_COMPLETION 的值）。

其他平台上，该返回值是剩余未 sleep 的秒数。
PHP 版本： 4+
PHP 更新日志：

8.0.0 - 此函数在负数 seconds 时抛出 ValueError，之前会引发 E_WARNING 且函数返回 false。

在 PHP 5.3.4 之前，当 Windows 上发生睡眠时，此函数始终返回 NULL。

PHP 杂项函数