usleep 是微秒级暂停,sleep 是秒级暂停;usleep(1000) 暂停 1 毫秒,sleep(1) 暂停 1 秒;usleep 最小有效值约 1000 微秒,sleep(0) 无效,Windows 下 usleep 在 PHP 中不可用。

usleep 是微秒级暂停,sleep 是秒级暂停
usleep 接收的是微秒(μs)为单位的整数,比如 usleep(1000) 暂停 1 毫秒;sleep 接收的是秒为单位的整数,比如 sleep(1) 暂停 1 秒。两者底层都调用系统 sleep 调用,但精度和适用场景差异明显。
常见错误是把 usleep(1000000) 当作“等 1 秒”来用——它确实≈1秒,但会多一次函数调用开销,且在高并发下不如 sleep(1) 稳定。反过来,用 sleep(0) 想让出 CPU 时间片也不行,它会被忽略(PHP 会直接返回)。
-
usleep最小有效值通常是 1000(即 1 毫秒),低于这个值可能被截断或无效果,取决于系统调度粒度 -
sleep参数必须是整数,传浮点数如sleep(0.5)会被强制转成0,实际不暂停 - Windows 下
usleep在 PHP time_nanosleep
高精度轮询时只能用 usleep,sleep 会卡死响应
做实时性要求稍高的轮询(比如监听文件变化、短周期 API 重试),用 sleep(1) 容易导致整体延迟放大:假设你每 100ms 检查一次,但用了 sleep(1),那实际间隔就变成 1 秒起跳。
示例:等待某个临时文件生成,最长等 500ms:
立即学习“PHP免费学习笔记(深入)”;
$timeout = microtime(true) + 0.5;
while (!file_exists('/tmp/ready.flag') && microtime(true) < $timeout) {
usleep(10000); // 每 10ms 查一次,共最多 50 次
}
如果这里写成 sleep(0.01),实际执行为 sleep(0),循环会疯狂占用 CPU;写成 sleep(1) 又直接超时失败。
sleep 可被信号中断,usleep 在多数 PHP 版本中不可中断
sleep 在收到 SIGALRM 或其他捕获信号时会提前返回,返回值是剩余秒数(比如调用 sleep(5) 后第 2 秒被中断,返回 3)。这在需要配合 pcntl 信号处理的守护进程中很重要。
usleep 在 PHP 7.4 之前基本不可被信号中断,调用期间信号会被挂起,直到暂停结束才触发——这意味着你在 usleep(5000000)(5 秒)里发 kill -USR1,PHP 不会立刻响应,得等它自己醒来。
- 若需中断能力 + 微秒级精度,PHP 7.4+ 可用
time_nanosleep,它支持信号中断且精度更高 - 旧版本中,折中做法是用短
usleep+ 外层判断标志位(如全局变量或 signal handler 设置的 flag)
CLI 和 Web SAPI 下行为一致,但超时限制不同
两个函数本身在 CLI 和 Apache/FPM 下表现一样,但 Web 环境受 max_execution_time 和服务器 timeout 配置制约更严。比如 sleep(30) 在默认配置下会让 PHP 脚本直接被 FPM kill 掉,而 usleep(30000000) 同样耗时 30 秒,却可能逃过部分超时检测(不推荐依赖这点)。
真正要注意的是:Web 请求中任何阻塞延时都会占用 worker 进程,usleep 并不能“减轻压力”,只是把大块阻塞拆成小块,对并发吞吐量无实质提升。真要异步等待,该上消息队列或 swoole 协程。
微秒级控制只在 CLI 工具、测试脚本、本地调试或低频后台任务中有意义;线上 Web 接口里混用 usleep 很容易掩盖真正的性能瓶颈,反而让问题更难定位。











