Laravel Packages

Monitor Code Processing Time in PHP with Time Warden

Published
Monitor Code Processing Time in PHP with Time Warden image

Time Warden is a lightweight PHP library that enables you to monitor the processing time of tasks and take actions on thresholds exceeding defined execution time limits. It's probably best illustrated with an example from the readme:

timeWarden()->task('Checking articles')->start();
 
foreach ($articles as $article) {
// Perform long process... πŸ•’
}
 
// Using traditional anonymous function
timeWarden()->stop(static function (Task $task): void {
$task->onExceedsMilliseconds(500, static function (Task $task): void {
// Do what you need, for example, send an email πŸ™‚
Mail::to('foo@bar.com')->queue(
new SlowArticleProcess($task)
);
});
});
 
// Or using an arrow function
timeWarden()->stop(static function (Task $task): void {
$task->onExceedsMilliseconds(500, fn (Task $task) => Log::error($task->name.' has taken too long'));
});

This library has excellent documentation in the project's readme, which in summary offers the following features:

  • Monitor processing time of critical tasks in development and debugging
  • Reactive actions when time is exceeded (milliseconds, seconds, minutes, and hours)
  • Execution time debugging output
  • Measure execution time of an individual task and groups of tasks
  • Framework-agnostic library you can use with Laravel, Symfony, standalone, etc.
  • PHP 8.2+

I like the output of tasks, which you can output directly or through a logging system:

 
echo timeWarden()->output();
/*
╔═════════════════════ TIMEWARDEN ═════╀═══════════════╗
β•‘ GROUP β”‚ TASK β”‚ DURATION (MS) β•‘
╠═════════════════════β•ͺ════════════════β•ͺ═══════════════╣
β•‘ default (320.37 ms) β”‚ Articles task β”‚ 70.23 β•‘
β•‘ β”‚ Customers task β”‚ 250.14 β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β• Total: 320.37 ms ══╧═══════════════╝
*/
 
// Send as a log
if (app()->environment('local')) {
Log::debug(timeWarden()->output());
}

You can learn more about this package, get full installation instructions, and view the source code on GitHub.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Sponsored

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article