php8.5
Home/ Manual/ swoole / timer/ Swoole\Timer::info

Swoole\Timer::info

PHP function Edit on GitHub ✎

Get information about a timer.

Description

Swoole\Timer::info(int $timer_id): array|null

Get information about a timer. As of Swoole 4.4.0.

Parameters

timer_id

The timer ID returned by Swoole\Timer::tick or Swoole\Timer::after.

Return Values

Returns an array describing the timer, or null if no timer with this ID exists in the current process. The array contains the following keys:

exec_msec

The time of the next execution, in milliseconds, counted from the moment the timer subsystem was started. It is not a duration.

exec_count

The number of times the callback has been executed. Available as of Swoole 4.8.0.

interval

The interval of the timer, in milliseconds.

round

The number of the timer loop round in which the timer was created.

removed

Whether the timer has been removed.

Examples

Swoole\Timer::info() example

php
<?php
$timer_id = Swoole\Timer::tick(1000, function () {});
var_dump(Swoole\Timer::info($timer_id));
Swoole\Timer::clear($timer_id);
?>

The above example will output something similar to:

output
array(5) {
  ["exec_msec"]=>
  int(1000)
  ["exec_count"]=>
  int(0)
  ["interval"]=>
  int(1000)
  ["round"]=>
  int(0)
  ["removed"]=>
  bool(false)
}

Source: reference/swoole/swoole/timer/info.xml · from the official PHP manual (php/doc-en)