Timer

Timer class for measuring how long things take.

The timer class can be used to time one or more events and returns how long it took in milliseconds.

Application Timer

The Hazaar\Application class has a built-in timer for measuring the performance of your application automatically. By default this timer is disabled. See the app.timer setting in Config Directives.

Properties

timers

Array of timers.

private array $timers

This is an associative array of timers. The key is the name of the timer and the value is an array with the

• start: The time the timer was started
• stop: The time the timer was stopped

If the timer is currently running, the stop key will not exist.

last

The name of the last timer. Used in checkpointing.

private string $last

precision

Timer Precision.

private int $precision

This sets the precision of the output. By default it is 2 which means output is 1/10th of a millisecond.

Methods

__construct

Timer class constructor.

public __construct(int $precision = 2, ?float $start): void

The timer class has an implicit timer that is always active called the 'global' timer. This is simply used to record how long the timer class itself has been active.

Parameters

Parameter	Type	Description
$precision	int	The precision to use when returning timer values. Defaults to 2.
$start	float

__toString

Magic toString method.

public __toString(): void

This will return a string representation of the current state of the default timer object.

start

Start a new timer.

public start(string $name = 'default', ?float $when): void

A timer is nothing more than a named point in time. When a timer starts, no long running code is executed or anything like that and simply the current system time in microseconds is recorded against the timer name. This allows us to later query that timer name and return the difference which will give you the number of milliseconds between two points in time.

Parameters

Parameter	Type	Description
$name	string	a name for the timer
$when	float	Optionally allow the start time to be overriden. Defaults to PHP's microtime(true) value.

stop

Stop a currently running timer and return it's value.

public stop(string $name = 'default'): void

Parameters

Parameter	Type	Description
$name	string	The name of the timer to stop. If the timer does not exist an exception is thrown.

checkpoint

Create a timer checkpoint.

public checkpoint(mixed $name): void

Simply put, this will automatically stop the last timer and start a new one in one function call.

Parameters

Parameter	Type	Description
$name	mixed	the name of the new timer

get

Get the current state of a timer.

public get(string $name = 'default', ?int $precision): float

If a timer is currently running, then it's value will be the difference between when it started and 'now'. If a timer has stopped, it's value will be the difference between when it was started and when it stopped.

Parameters

Parameter	Type	Description
$name	string	The name of the timer to stop. If the timer does not exist an exception is thrown.
$precision	int	The precision of the returned value. If not specified the precision used in the constructor is used.

all

Get an array of all timers and their current state.

public all(?int $precision): void

Parameters

Parameter	Type	Description
$precision	int	The precision of the returned values. If not specified the precision used in the constructor is used.

reset

public reset(): void

---

Generated by Hazaar API Doc Generator on Mon, 27 Oct 2025 13:01:29 +0000