Stopwatch, CSV logger and time converter (seconds to readable string)., (*1)
Install
Put this in a composer.json:, (*2)
{
"require": {
"zdenekdrahos/profiler-tools": "*"
}
}
Usage
``` php
// start stopwatch
$stopwatch = ProfilerTools\stopwatch();, (*3)
// execute something, (*4)
// stop timer
list($start, $end, $elapsedSeconds) = $stopwatch();, (*5)
// log execution time
appendCsvLine(
'log.csv'
array(
$start->format('c'),
$end->format('c'),
ProfilerTools\secondsToDays($elapsedSeconds)
)
);, (*6)
Logger appends following line to `log.csv`:
2015-02-01T09:15:17+01:00,2015-02-01T09:15:18+01:00,1.1s, (*7)
### 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](src/ExecutionReport.php). Take a look at example with *hidden* stopwatch:
``` php
$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., (*8)
Wallogit.com
