mc0de/console-timer

A trait for tracking execution time in Laravel console commands

1.0.3 2025-04-28 19:27 UTC

This package is auto-updated.

Last update: 2025-04-28 19:31:31 UTC


README

Latest Version on Packagist Total Downloads License

A simple trait that adds execution time tracking to your Laravel console commands. Useful for:

  • Tracking how long your commands take to run
  • Measuring specific operations within commands
  • Debugging slow operations
  • Getting timing feedback during long-running processes

Console Timer

Features

  • Track total command execution time
  • Measure individual operations
  • Get operation return values
  • Format durations in a readable way
  • Start/stop measurements manually or with closures

Requirements

  • PHP ^8.1
  • Laravel 10.x|11.x|12.x

Installation

composer require mc0de/console-timer

Usage

Basic Usage

Add the trait to your command and wrap operations you want to measure:

use Mc0de\ConsoleTimer\ConsoleTimer;
use Illuminate\Console\Command;

class YourCommand extends Command
{
    use ConsoleTimer;

    public function handle()
    {
        $this->startCommandTimer();

        $this->measure('Processing items', function () {
            // Your processing logic
        });

        $this->displayCommandTime();
    }
}

Getting Return Values

$result = $this->measure('Fetching data', function () {
    return ['data' => 'value'];
});

// $result contains ['data' => 'value']

Manual Timing

For operations that span multiple methods:

public function handle()
{
    $this->startCommandTimer();

    $this->startMeasure('Processing items');
    $this->processItems();
    $this->finishMeasure();

    $this->displayCommandTime();
}

protected function processItems()
{
    // This method is part of the measured operation
}

Example Output

  19:17:45 Fetching CRM data ........................................ 1.92s ✓
  19:17:47 Syncing product catalog .................................. 2.34s ✓
  19:17:49 Processing user data ..................................... 394ms ✓
  19:17:49 Running ML recommendations ............................... 3.76s ✓
  19:17:53 Generating sales report .................................. 899ms ✓
  19:17:54 Creating analytics dashboard ............................. 5.26s ✓
  19:17:59 Saving to database ....................................... 389ms ✓

  Completed in 14.99s

Methods

  • startCommandTimer() - Start tracking total command time
  • measure(string $message, Closure $callback) - Measure an operation and show progress
  • startMeasure(string $message) - Start measuring without a closure
  • finishMeasure() - End the current measurement
  • displayCommandTime() - Show total command execution time

License

MIT License - see LICENSE.md