# sleep

(PHP 4, PHP 5, PHP 7)

sleep — 延缓执行

### 说明

sleep ( int `$seconds` ) : int

程序延迟执行指定的 `seconds` 的秒数。

### 参数

`seconds`

  暂停的秒数。

### 返回值

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

如果函数的调用被一个信号中止，sleep() 会返回一个非零的值。在Windows上，该值总是 192（即Windows API常量`WAIT_IO_COMPLETION`的值）。其他平台上，该返回值是剩余未sleep的秒数。

### 错误／异常

如果指定的 `seconds` 是负数，该函数会产生一个 `E_WARNING` 级别的错误。

### 更新日志

版本 | 说明
--- | ---
5.3.4 | 在PHP 5.3.4之前，Windows平台下无论 sleep() 是否成功调用，总是会返回一个 `NULL`。

### 范例

Example #1 sleep() 的例子

    <?php

    // current time
    echo date('h:i:s') . "\n";

    // sleep for 10 seconds
    sleep(10);

    // wake up !
    echo date('h:i:s') . "\n";

    ?>

该例子会在休眠10秒后输出。

    05:31:23
    05:31:33

### 参见

- usleep() - 以指定的微秒数延迟执行
- time_nanosleep() - 延缓执行若干秒和纳秒
- time_sleep_until() - 使脚本睡眠到指定的时间为止。
- set_time_limit() - 设置脚本最大执行时间