https://github.com/sbwerewolf/stopwatch
Primitive stopwatch with simple start and stop for measurement of periods and whole time
https://github.com/sbwerewolf/stopwatch
duration hrtime microtime php-library stopwatch
Last synced: 26 days ago
JSON representation
Primitive stopwatch with simple start and stop for measurement of periods and whole time
- Host: GitHub
- URL: https://github.com/sbwerewolf/stopwatch
- Owner: SbWereWolf
- License: mit
- Created: 2023-02-07T00:24:30.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-02-10T23:48:36.000Z (over 2 years ago)
- Last Synced: 2025-07-29T23:17:55.601Z (2 months ago)
- Topics: duration, hrtime, microtime, php-library, stopwatch
- Language: PHP
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Simple stopwatch
Primitive stopwatch, with simple start and stop methods,
for measurement of every single time periods and all time whole.
## How to install
`composer require sbwerewolf/stopwatch`
## How to use
```php
echo 'Duration is ' .
(new \SbWereWolf\Stopwatch\HRTimeStopwatch())
->start()->stop()->getLastTime()->asNanoSeconds() .
' ns' .
PHP_EOL;
```
```bash
Duration is 300 ns
```
Stopwatch available with different engines:
- `hrtime()`
- `microtime()`
- `DateTimeImmutable`
`\SbWereWolf\Stopwatch\HRTimeStopwatch` implements
`hrtime()` engine.
`\SbWereWolf\Stopwatch\MicroTimeStopwatch` implements
`microtime()` engine.
`\SbWereWolf\Stopwatch\DateTimeStopwatch` implements
`DateTimeImmutable` engine.
## Advanced usage
```php
$stopwatch = new SbWereWolf\Stopwatch\HRTimeStopwatch();
echo (new DateTimeImmutable())->format('s.u') . PHP_EOL;
$stopwatch->start();
time_nanosleep(0, 100);
$stopwatch->stop();
echo (new DateTimeImmutable())->format('s.u') .
' Period 1 duration: ' .
$stopwatch->getLastTime()->asNanoSeconds() .
' ns' .
PHP_EOL;
time_nanosleep(0, 100);
$stopwatch->start();
time_nanosleep(0, 100);
$stopwatch->stop();
echo (new DateTimeImmutable())->format('s.u') .
' Period 2 duration: ' .
$stopwatch->getLastTime()->asNanoSeconds() .
' ns' .
PHP_EOL;
/* Summa of all time periods */
echo (new DateTimeImmutable())->format('s.u') .
' Periods 1 + 2 summary duration: ' .
$stopwatch->getSummaryTime()->asNanoSeconds() .
' ns' .
PHP_EOL;
/* Overall time */
echo (new DateTimeImmutable())->format('s.u') .
' Whole process duration: ' .
$stopwatch->getWholeTime()->asNanoSeconds() .
' ns' .
PHP_EOL;
```
```bash
02.380004
02.380020 Period 1 duration: 12400 ns
02.380032 Period 2 duration: 3600 ns
02.380035 Periods 1 + 2 summary duration: 16000 ns
02.380044 Whole process duration: 24000 ns
```
## Using a stopwatch to benchmark any process
```php
$stopwatch = new SbWereWolf\Stopwatch\HRTimeStopwatch();
$benchmark = new SbWereWolf\Stopwatch\Benchmark($stopwatch);
$delay = 100;
echo "Variable value before step z callback `$delay`" . PHP_EOL;
/* Variable value before step z callback `100` */
$benchmark->step('z', function () use ($delay) {
time_nanosleep(0, $delay);
$delay++;
});
echo "after step z callback `$delay`" . PHP_EOL;
/* after step z callback `100` */
/* Variable does not change its value */
$benchmark->step('x', function () use (&$delay) {
time_nanosleep(0, $delay);
$delay += 999;
});
echo "after step x callback `$delay`" . PHP_EOL;
/* after step x callback `1099` */
/* Variable does change its value */
$benchmark->step('c', function () use (&$delay) {
$delay -= 999;
time_nanosleep(0, $delay);
});
echo "after step c callback `$delay`" . PHP_EOL;
/* after step c callback `100` */
/* Variable does change its value */
echo "Benchmark steps measurement is:" . PHP_EOL;
$i=0;
foreach ($benchmark->report() as $desc => $val) {
/** @var SbWereWolf\Stopwatch\ITimerReadings $val */
echo "$desc => {$val->asNanoSeconds()} ns" . PHP_EOL;
$i++;
}
$totalNanoseconds = $benchmark->total()->asNanoSeconds();
echo "Total is $totalNanoseconds ns";
```
```bash
variable value before step z `100`
after step z `100`
after step x `1099`
after step c `100`
Benchmark steps measurement is:
z => 15800 ns
x => 7600 ns
c => 4100 ns
Total is 27500 ns
```
## Contacts
```
Volkhin Nikolay
e-mail ulfnew@gmail.com
phone +7-902-272-65-35
Telegram @sbwerewolf
```
Chat with me via messenger
- [Telegram chat with me](https://t.me/SbWereWolf)
- [WhatsApp chat with me](https://wa.me/79022726535)