2022-12-24 22:10:40 +08:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Illuminate\Support;
|
|
|
|
|
|
|
|
class Timebox
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* Indicates if the timebox is allowed to return early.
|
|
|
|
*
|
|
|
|
* @var bool
|
|
|
|
*/
|
|
|
|
public $earlyReturn = false;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Invoke the given callback within the specified timebox minimum.
|
|
|
|
*
|
2024-01-31 22:15:08 +08:00
|
|
|
* @template TCallReturnType
|
|
|
|
*
|
|
|
|
* @param (callable($this): TCallReturnType) $callback
|
2022-12-24 22:10:40 +08:00
|
|
|
* @param int $microseconds
|
2024-01-31 22:15:08 +08:00
|
|
|
* @return TCallReturnType
|
2022-12-24 22:10:40 +08:00
|
|
|
*/
|
|
|
|
public function call(callable $callback, int $microseconds)
|
|
|
|
{
|
|
|
|
$start = microtime(true);
|
|
|
|
|
|
|
|
$result = $callback($this);
|
|
|
|
|
|
|
|
$remainder = intval($microseconds - ((microtime(true) - $start) * 1000000));
|
|
|
|
|
|
|
|
if (! $this->earlyReturn && $remainder > 0) {
|
|
|
|
$this->usleep($remainder);
|
|
|
|
}
|
|
|
|
|
|
|
|
return $result;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Indicate that the timebox can return early.
|
|
|
|
*
|
|
|
|
* @return $this
|
|
|
|
*/
|
|
|
|
public function returnEarly()
|
|
|
|
{
|
|
|
|
$this->earlyReturn = true;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Indicate that the timebox cannot return early.
|
|
|
|
*
|
|
|
|
* @return $this
|
|
|
|
*/
|
|
|
|
public function dontReturnEarly()
|
|
|
|
{
|
|
|
|
$this->earlyReturn = false;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sleep for the specified number of microseconds.
|
|
|
|
*
|
|
|
|
* @param int $microseconds
|
|
|
|
* @return void
|
|
|
|
*/
|
|
|
|
protected function usleep(int $microseconds)
|
|
|
|
{
|
|
|
|
usleep($microseconds);
|
|
|
|
}
|
|
|
|
}
|