sandermuller/stopwatch

Stopwatch for PHP & Laravel

A lightweight profiler for PHP and Laravel. Add checkpoints, measure closures, track queries, memory and outbound HTTP, and see where the time goes. Use it when a request, command or job feels slow and an APM is more than you need. It runs in production, in tests and in CI.

It also works as a debugger you read afterwards: with STOPWATCH_DEBUG=true, stopwatch()->probe('label', [...]) calls are written to disk as they happen, and php artisan stopwatch:runs:show latest shows their values in execution order. An AI agent can run that loop on its own.

PHP 8.3+ · Laravel 12.x / 13.x

Installation

composer require sandermuller/stopwatch
php artisan vendor:publish --tag=stopwatch-config   # optional

Quick start

stopwatch()->withQueryTracking()->start();

$users  = User::all();
stopwatch()->checkpoint('Load users');

$orders = Order::where('status', 'pending')->get();
stopwatch()->checkpoint('Load orders');

stopwatch()->toLog('Profile:');
// Profile:
//   [3ms / 3ms]   Load users  (queries=1)
//   [12ms / 15ms] Load orders (queries=1)
//   Total: 15ms

checkpoint() starts the stopwatch on its own, so start() is only needed to reset an earlier run.

Render it as a self-contained HTML card instead:

@stopwatch

Documentation

Published at https://sandermuller.github.io/Stopwatch/.

• Why Stopwatch?: what it answers, and when an APM is the better tool
• Installation · Getting started · Checkpoints · Query, memory and HTTP tracking
• HTML report · Profiler toolbar · Server-Timing and Debugbar
• Persistent run log · Crash diagnostics · Debugging with probes
• Slow-run notifications · AI assistant integration · Standalone PHP
• Configuration · API

The sources are in docs/.

Testing

composer test

Changelog

CHANGELOG lists the recent changes.

Contributing

CONTRIBUTING covers local setup and the pull-request process.

Security vulnerabilities

Report a vulnerability through the security policy rather than a public issue.

Credits

• Sander Muller
• All Contributors

License

The MIT License (MIT). Please see the License File for more information.