杂项 函数
在线手册:中文  英文

usleep

(PHP 4, PHP 5)

usleep以指定的微秒数延迟执行

说明

void usleep ( int $micro_seconds )

以指定的微秒数延缓程序的执行。

参数

micro_seconds

暂停的时间以微秒计。1微秒(micro second)是百万分之一秒。

返回值

没有返回值。

更新日志

版本 说明
5.0.0 此函数在Windows系统下可用。

范例

Example #1 usleep()例子

<?php

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

// wait for 2 seconds
usleep(2000000);

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

?>

以上例程会输出:

11:13:28
11:13:30

参见


杂项 函数
在线手册:中文  英文

用户评论:

marc dot etter at swissonline dot ch (2011-08-17 01:26:49)

There is a very strange behaviour, which I experience under Win7 64-bit, PHP 5.3.6:

The very first call of usleep of the PHP script will (sometimes) wait significantly shorter than it actually should.

<?php
usleep
(1); // Dodge the strange behaviour
for ($i 0$i 20$i++) // Reapet 20 times
{
    
$start_time microtime(true); // save start time
    
usleep(10000); // wait theoretical 10ms
    
$end_time microtime(true); // save end time
    
$wait_time[] = ($end_time $start_time) * 1000// calc the difference (which should be around 10ms)
}
var_dump($wait_time); // dump all the results
?>

If you leave away the first line (usleep(1);) you will get varying values for $wait_time[0] between 1 and 13, whilst all the other values are around 15 (for me).

adrian dot voica at gmail dot com (2009-10-12 07:15:48)

VERY VERY IMPORTANT!!! 

Under Windows systems, if you do not set the time limit of the execution of your script to 0 ("set_time_limit(0);"), the php executable will eat as much as 50% CPU power when using sleep or usleep functions. 

This is an extremely annoying behavior. It took me a lot of time to figure it out. It may have something to do with the fact that the usleep and sleep are "supervised" by the time limit set by set_time_limit() which defaults to 30 seconds; --that's just my assumption. I may be wrong, I am only human ;)

It's quite simple, but the set_time_limit() function is poorly documented at this level.

<?php
 set_time_limit
(0); // Remove the time limit for command-line usage;
 
$counter 0// Some simple counter;
 
while ($counter 100) { // Do nothing for 100*100 miliseconds (10 seconds);
  
$counter++;
  
usleep(100000); // Sleep for 100 miliseconds;
 
}

Good luck!

Docey (2007-05-27 14:19:36)

WARNING!!
the snippet below by 'Marius (mm at co-operation dot de)' is NOT a usleep and it will keep the CPU at 100% running. why people keep posting that crap is a complete mystery for me.
the idea of sleep and usleep is that by letting the cpu run a few idle cycles so the other programs can have some cycles run of their own. what results in better response times and lower overall system-load. so if you have to wait for something, go to sleep for a few seconds instead of occupying the cpu while doing absolute nothing but waitting.

Mike at SevenCode dot com (2007-01-11 03:36:14)

Dude you are SO the man for that code snippet. It worked like a charm. I just wanted to point out a couple things and offer my own improvement.
1. If you're like me, you were probably wondering why the socket had to keep being recreated on each call, and why you couldn't just create a static socket. Its because socket_select assumes you're passing in a pointer, and will alter the variable on return to reflect the actual sockets that were changed.
2. I couldn't figure out for the life of me why socket_select wasn't defined. Its because you hadn't enabled the right extension in php.ini
Ok so heres my slight improvement. The only real thing I did is use a static variable for the socket, to avoid creating a brand new socket on each call of this function. I'm not sure if socket creation will cause things to crash down the line like the other problems reported on here, but if you ask me better safe then sorry.
function Sleeper($mSec)
{
// For dummies like me who spent 5 minutes
// wondering why socket_create wasn't defined
if(!function_exists('socket_create')){
die("Please enable extension php_sockets.dll");
}
// So the socket is only created once
static $socket=false;
if($socket===false){
$socket=array(socket_create(AF_INET,SOCK_RAW,0));
}
$pSock=$socket;

// Calc time
$uSex = $mSec * 1000;
// Do the waiting
socket_select($read=NULL,$write=NULL,$pSock,0,$uSex);

// OCD
return true;
}

php_manual at lk2 dot de (2006-12-28 14:16:28)

I have no idea why nobody came up with this yet, but there is an efficient way to reproduce usleep() under windows:

<?php
function usleep_win($msec) {
   
$usec $msec 1000;
   
socket_select($read NULL$write NULL$sock = array(socket_create (AF_INETSOCK_RAW0)), 0$usec);
}
?>

* Doesnt busy wait
* Doesnt eat memory
* Works for millions of repetitions
* Seems to be rather efficient

It seems that the average error (on my machine) is about 5ms (it sleeps 5ms more than intended) thats probably due to code execution as well as kernel timers.

A socket without any purpose is highly unlikely to every cause an exception, so socket_select will always sleep until the timeout is hit.

Rasmus Schultz (2006-08-23 06:39:51)

I have spent DAYS trying to create a reliable usleep()-replacement for Windows.
I have only this to offer:
As commented by someone else already, the gettimeofday() method used below is useless - PHP will use all available CPU power doing nothing.
The fsockopen() method apparently is also useless - as someone else commented, an fclose() was missing in the original post, but this apparently does not solve the problem. After calling the function about 50 or so times, fsockopen() returns immidiately, without any delay - and watching a process monitor in Windows, you can then watch the process taking up increasingly more memory, until eventually PHP aborts (or crashes) when it reaches maximum.
The win32api-method is also a no-go ... after calling the Sleep function a few hundred times (during which memory usage will also go up every time due to a memory leak somewhere), PHP will cause an exception and Windows will terminate it.
I have given up - I don't think there is any viable solution to this problem under PHP 4.
If you need this function, upgrade your project to PHP 5.
Or settle for 1-second delays with the sleep()-function.
These, unfortunately, seem to be your only options...

Patrick (2006-07-26 13:04:34)

I want to create a daemon/Linux service. Here is an example of how to run a process that has "throttle control"
// You must set these
//
// max_execution_time = 0
// max_input_time = 0
function doProcess() {
echo "Start"."\n";
usleep(10000);
echo "Stop"."\n";
return false;
}
function manageProcess() {
// Setup data
$runsPerMinute = 200;
$maxMinuteAverage = 5;
$waitIfNotWorking = 120; // seconds
// Conversion
$microsPerSecond = 1000000;
// Statistical Info
$currentMinute = 0;
$minute = -1;
$countPerMinute = array();
$sumPerMinute = array();
// Totals
$totalProcessTime = 0;
$totalCounts = 0;
while (true) {
$timestart = microtime();
$performedWork = doProcess();
$timeend = microtime();
if (!$performedWork) {
// Statistical Info
$currentMinute = 0;
$minute = -1;
$countPerMinute = array();
$sumPerMinute = array();
sleep($waitIfNotWorking);
} else {
$ts = split(" ",$timestart);
$te = split(" ",$timeend);
$te[0] = ($te[0] * $microsPerSecond) - ($ts[0] * $microsPerSecond);
$te[1] = ($te[1] - $ts[1]) * $microsPerSecond;
$processTime = $te[0] + $te[1];
if (date("i")<>$minute) { // We are NOT in the same minute
// Reset the new minute
$minute = date("i");
$currentMinute = ($currentMinute+1) % $maxMinuteAverage;
// Remove Statistical Information from the minute we are expiring.
if (isset($countPerMinute[$currentMinute])) {
$totalProcessTime = $totalProcessTime - $sumPerMinute[$currentMinute];
$totalCounts = $totalCounts - $countPerMinute[$currentMinute];
}
$countPerMinute[$currentMinute] = 0;
$sumPerMinute[$currentMinute] = 0;
}
$countPerMinute[$currentMinute] = $countPerMinute[$currentMinute] + 1;
$sumPerMinute[$currentMinute] = $sumPerMinute[$currentMinute] + $processTime;
$totalCounts = $totalCounts + 1;
$totalProcessTime = $totalProcessTime + $processTime;
$averageRuntime = round($totalProcessTime / $totalCounts);
$waitTime = (($microsPerSecond*60) / $runsPerMinute) - $averageRuntime;
usleep($waitTime);
}
}
}
manageProcess();

gizmo at aoaforums dot com (2006-02-02 21:28:26)

It should be noted that Windows machines have a resolution of either 10 mS or 15 mS (depending on the chipset implementation and HAL used) when using the Sleep() function in kernel32.dll. This means that your average error will be either 5 or 7.5 mS. This is not ordinarily a problem unless you really NEED to sleep for less time than the granularity provided by Windows.

gmc at serveisw3 dot net (2005-07-07 21:11:47)

If you're using Windows then you maybe are in trouble with usleep if you really need to use it.
The Bernie's microdelay function using fsockopen does not work properly, and the fclose doesn't help much.
I don't know if network connections go strange, but I know it does not work since you've made more than 2000 - 3000 calls to it, so it's not a reliable solution in 'long life' php scripts, or these are the issues of the microdelay function in my PHP and PHP-GTK applications.
Though another solution should be found, and googling a bit I fount a WinAPI function: Sleep.
So I get with this snippet wich works fine for me, you get milliseconds precission but the more important, it works for long-run scripts and of course, it does not waste any CPU cycles.
dl('php_w32api.dll');
$GLOBALS['win32api'] =& new win32;
// USleep alternative for Windows and PHP4:
$GLOBALS['win32api']->registerfunction("long Sleep (long dwMillisecods) From kernel32.dll");
// Now you can call the function from everywhere in your script: $GLOBALS['win32api']->Sleep(milliseconds);
for ($msec = 2000; $msec > 0; $msec = $msec - 125) {
echo "Hi. Next one in $msec msec.\n";
$GLOBALS['win32api']->Sleep($msec);
}

t0russ at gmail dot com (2005-05-03 08:06:35)

solution to the warning posted by Bertie:
$f=@fsockopen("tcp://localhost",$UNUSED_PORT,$errno,$errstr,$delay);
@fclose($f);

brian dot hollenbeck at gmail dot com (2005-03-25 04:28:22)

Just a tip for the folks at home: is you use multiple rand() functions in your code, be sure to put a randomized usleep() in between the rand() codelines, or else your "random" seeds won't be so random on a fast server.
Example:
$string = rand(0, 100);
$string = rand(0, 200);
Instead:
$string = rand(0, 100);
usleep(rand(1000, 10000));
$string1 = rand(0, 100);

Bertie (2003-11-28 11:47:17)

A word of warning about the microdelay() code posted that uses the fsockopen - if you use this is a loop that delays for small periods you will very quickly run out of sockets/socket buffer space. And then your network connections go very strange......

grail dot ink at unix dot net (2003-08-29 02:06:19)

We have developed an alternative to usleep that should work on any platform and it doesn't eat up any CPU cycles. It's been tested on Windows 2000 w/ Apache. Other platforms should work fine.
function microdelay($delay) {
$UNUSED_PORT=31238; //make sure this port isn't being used on your server
@fsockopen("tcp://localhost",$UNUSED_PORT,$errno,$errstr,$delay);
}
It times out after a specified time in seconds. It uses a double as argument so you can specify decimal arguments.
microdelay(.5); //500ms
microdelay(.25); //250ms
microdelay(2.25); //2250ms
Our small contribution to this great language!
http://www.xencoders.com

jadd0r at mail dot com (2003-04-08 10:59:33)

You could do neat things with this like for unix:

<?php
$y
=1000000;
for (
$x=1$x<50$x++) {
echo 
chr(7);
usleep($y*(pow(0.9,$x)+0.2));
}
?>

then execute
`php -q script.php > /dev/console`

will result in a bombtimer (chr(7) is beep character) :]

busby at edoceo dot com (2003-01-17 16:04:49)

Should be noted that functions that loop really fast to create a delay also consume 100% CPU while doing the loop. Try creating a dummy loop that goes 100000 times, watch it choke your machine. If you really need usleep() don't use windows.

dsc at c2i dot net (2002-03-14 21:55:55)

The usleep() for Windows above doesn't take into account that the value of $stop can be lower than $start. It also contains unnecessary casts and $temp variable. Here is a better function:
function usleepWindows($usec)
{
$start = gettimeofday();
do
{
$stop = gettimeofday();
$timePassed = 1000000 * ($stop['sec'] - $start['sec'])
+ $stop['usec'] - $start['usec'];
}
while ($timePassed < $usec);
}

dave at techweavers dot net (2000-12-28 19:29:46)

To monitor a scripts CPU ussage and avoid any nasty CPU gobbling loops you can use this function (will not work with windows or safe mode) I know it works on FreeBSD:
function phpmon($max)
{
$cmd = `ps -Unobody -r -o%cpu`;
$lines = explode("\n", $cmd);
$usage = substr($lines[1], 0, strpos($lines[1], "."));
$sleeprate = 500;
while ($usage >= $max)
{
$cmd = `ps -Unobody -r -o%cpu`;
$lines = explode("\n", $cmd);
$usage = substr($lines[1], 0, strpos($lines[1], "."));
usleep($sleeprate);
}
}
phpmon($MAX);
where $MAX is the maximum CPU you want the process to consume. e-mail me with any improvements/suggestions.
I have noticed that this consumes a lot of system CPU (at least in my limited testing) possibly from all of the system calls or the huge mathematical functions I used to test the effectiveness of the script.

易百教程