Stopwatch, CSV logger and time converter (seconds to readable string)
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.
src
tests
.gitignore
LICENSE
README.md
composer.json
example.php

README.md

Simple PHP Profiler Tools

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.