Skip to content
Profile your Kirby 3 CMS code with precision in milliseconds (or seconds)
PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
classes
tests
vendor
.coveralls.yml
.editorconfig
.gitignore
.php_cs.dist
.travis.yml
LICENSE
README.md
composer.json
composer.lock
index.php
phpunit.xml

README.md

Kirby 3 Stopwatch

Release Stars Downloads Issues Build Status Coverage Status Maintainability
Demo Gitter Twitter

Profile your Kirby 3 CMS code with precision in milliseconds (or seconds).

Commercial Usage

This plugin is free but if you use it in a commercial project please consider to

Installation

  • unzip master.zip as folder site/plugins/kirby3-stopwatch or
  • git submodule add https://github.com/bnomei/kirby3-stopwatch.git site/plugins/kirby3-stopwatch or
  • composer require bnomei/kirby3-stopwatch

Works well with

Usage Site Method

Please read the Symfony Stopwatch Component Docs since this plugin is just a soft wrapper around it. Some Examples:

Event Duration

site()->stopwatch()->start('myevent');
sleep(1);
site()->stopwatch()->stop('myevent');
echo site()->stopwatch()->duration('myevent') . PHP_EOL; // float | int

Event with Laps aka Periods

$eventName = 'my event with laps';
$stopwatch = site()->stopwatch();
$stopwatch->start($eventName);
foreach ([random_int(100,500),random_int(100,500),random_int(100,500)] as $time) {
    usleep($time);
    $stopwatch->lap($eventName);
}
usleep(100);
$stopwatch->stop($eventName);
$totalDuration = $stopwatch->duration($eventName); // float | int
echo $totalDuration . PHP_EOL;
foreach ($stopwatch->getEvent($eventName)->getPeriods() as $period) {
    echo $period->getDuration() . PHP_EOL;  // float | int
}

Usage PHP Class

You can use the provided php class in your own classes if you make sure the class is loaded before you call it. This can be done in installing this plugin using composer or in manually requiring it with Kirby's class loader.

$stopwatch = \Bnomei\Stopwatch::singleton();
$stopwatch->start('my event with laps');
sleep(1);
$stopwatch->stop('my event with laps');
$duration = $stopwatch->duration('my event with laps'); // float | int

Settings

bnomei.stopwatch. Default Description
precision true measure microseconds as float or int seconds.

NOTE: This plugin defaults to measuring in milliseconds but the symfony component does not.

Dependencies

Disclaimer

This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.

License

MIT

It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.

You can’t perform that action at this time.