Chronometer

Measure the passing of time -- by, Chris Kankiewicz (@phlak.dev), logo by Caneco

Introduction

Chronometer is a library for statically measuring the passing of time in your code. It's intended to be used for benchmarking code execution time.

Requirements

• PHP >= 8.2

Install with Composer

composer require phlak/Chronometer

Using Chronometer

First, import Chronometer.

use PHLAKChronometerTimer;

Then start your timer, run your code, stop the timer and get the elapsed time.

Timer::start();
// do something you want to measure...
Timer::stop();

return Timer::elapsed();

After running your timer you will need to reset it before using it again.

Timer::reset();

You may optionally reset the timer when you start it with the $reset parameter.

Timer::start(reset: true);

Usage

start

Start the timer.

ChronometerTimer::start( [ $reset = false ] ) : float

Example

ChronometerTimer::start(); // Returns something like 1538016612.1692

---

stop

Stop the timer.

ChronometerTimer::stop( void ) : float

Example

ChronometerTimer::stop(); // Returns something like 1538016632.7721

---

addLap

Add a new lap.

ChronometerTimer::addLap( [ string $description = null ] ) : ChronometerLap

Example

$lap = ChronometerTimer::addLap('The first lap.');

$lap->time // Returns something like 1538016625.492
$lap->duration // Returns something like 7.999922990799
$lap->description // Returns 'The first lap.'

---

started

Return the timer start time.

ChronometerTimer::started( void ) : float

Example

ChronometerTimer::started(); // Returns something like 1538016612.1692

---

stopped

Return the timer stop time.

ChronometerTimer::stopped( void ) : float

Example

ChronometerTimer::stopped(); // Returns something like 1538016632.7721

---

elapsed

Return the total time elapsed in seconds.

ChronometerTimer::elapsed( void ) : float

Example

ChronometerTimer::elapsed(); // Returns something like 20.602929115295

---

lastLap

Return the last lap.

ChronometerTimer::lastLap( void ) : ChronometerLap

Example

$lap = ChronometerTimer::lastLap();

$lap->time // Returns something like 1538016632.7721
$lap->duration // Returns something like 7.2800490856171

---

laps

Return an array of all laps.

ChronometerTimer::laps( void ) : array

Example

ChronometerTimer::laps(); // Returns an array of Lap objects

---

reset

Reset the timer state.

ChronometerTimer::reset( void ) : void

Example

ChronometerTimer::reset();

---

Changelog

A list of changes can be found on the GitHub Releases page.

Troubleshooting

For general help and support join our GitHub Discussion or reach out on Bluesky.

Please report bugs to the GitHub Issue Tracker.

Copyright

This project is licensed under the MIT License.