zdenekdrahos / profiler-tools
Helper functions - stopwatch, logger and time converter (seconds to readable string)
Installs: 1 754
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=5.3.0
Requires (Dev)
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 lineProfilerTools\appendCsvLines($file, array $rows)
- appends N lines in one write operationProfilerTools\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.