zdenekdrahos/profiler-tools

This package is abandoned and no longer maintained. No replacement package was suggested.

Helper functions - stopwatch, logger and time converter (seconds to readable string)

v1.2.0 2015-02-15 09:01 UTC

This package is auto-updated.

Last update: 2022-05-24 00:03:50 UTC


README

Stopwatch, CSV logger and time converter (seconds to readable string).

Install

Put this in a composer.json:

{
    "require": {
        "zdenekdrahos/profiler-tools": "*"
    }
}

Usage

// start stopwatch
$stopwatch = ProfilerTools\stopwatch();

// execute something

// stop timer
list($start, $end, $elapsedSeconds) = $stopwatch();

// log execution time
appendCsvLine(
    'log.csv'
    array(
        $start->format('c'),
        $end->format('c'),
        ProfilerTools\secondsToDays($elapsedSeconds)
    )
);

Logger appends following line to log.csv:

2015-02-01T09:15:17+01:00,2015-02-01T09:15:18+01:00,1.1s

No temporal coupling

execute something is the tricky part of the previous example. You could get easily coupled to start and stop stopwatch. You can use passing closure to monitorExecution which returns execution report. Take a look at example with hidden stopwatch:

$report = ProfilerTools\monitorExecution(function() {
    // execute something
});
ProfilerTools\appendCsvLine('log.csv', array(
    $report->dateStart->format('c'),
    $report->dateFinish->format('c'),
    $report->convertSecondsToReadableString(),
    $report->elapsedSeconds,
    $report->hasFailed() ? $report->exception->getMessage() : ''
));

Stopwatch

  • $stopwatch = ProfilerTools\stopwatch() - starts timer and returns function for stopping timer
  • $stopwatch() - returns start/end date and elapsed seconds
  • $report = ProfilerTools\monitorExecution(closure) - monitors function call and returns report

Logger

  • ProfilerTools\appendCsvLine($file, array $row) - converts array to line and append the line
  • ProfilerTools\appendCsvLines($file, array $rows) - appends N lines in one write operation
  • ProfilerTools\clearLog($file) - deletes existing content of file

Time converter

  • ProfilerTools\secondsToDays($elapsedSeconds, $precision) - converts seconds to readable format, optional milliseconds precions

Examples

Seconds .00s .0s
0.1546456 0.15s 0.2s
9 9s 9s
19.7878 19.79s 19.8s
65 1m 5s 1m 5s
374 6m 14s 6m 14s
12805.9 3h 33m 25.9s 3h 33m 25.9s
86922.298 1d 8m 42.3s 1d 8m 42.3s

License

Copyright (c) 2015 Zdeněk Drahoš. MIT Licensed, see LICENSE for details.