Repolode
Submit
itsgoingd

itsgoingd/clockwork

A PHP development tool that shows request data, queries, logs, timelines and more in your browser, mainly for Laravel apps.

Open-source alternative to:Laravel Telescope

View on GitHubWebsite
Stars
5,947
Forks
331
Open issues
39
Last commit
2 months ago

What is it?

Clockwork is a PHP development tool that gives you visibility into your application at runtime. It collects request data, performance metrics, log entries, database queries, cache and Redis commands, dispatched events, queued jobs, and rendered views for HTTP requests, Artisan commands, queue jobs and tests.

This repository is the server-side component. It is installed with Composer and collects data while the app runs. The collected data can be viewed through a built-in `/clockwork` web interface, a Chrome or Firefox browser extension, or a client-side toolbar. Collection can be limited to on-demand mode, error responses, slow responses, or requests matched by a custom closure.

Developers can log arbitrary variables with the `clock()` helper, which returns its first argument so it can be inserted inline. A timeline API lets you mark named sections of code and see how long they take.

Key features

  • 01Collects requests, database and cache queries, Redis commands, logs, events, jobs and views.
  • 02Works with HTTP requests, Artisan commands, queue jobs and tests.
  • 03View data in a built-in web page, a browser extension, or a toolbar.
  • 04Configurable collection modes such as on-demand, errors only, and slow only.
  • 05Logs variables with the clock() helper and marks code timing with a timeline API.
  • 06Detects duplicate (N+1) database queries and captures stack traces.

Use cases

  • Debugging a Laravel application's database queries and performance during development.
  • Inspecting API requests made by a mobile app or frontend without a browser-based debugger.
  • Profiling queue jobs and Artisan commands to see where time is spent.
  • Logging variables inline while tracing a bug in PHP code.

Quick start

  1. 1

    Install the library with Composer

    composer require itsgoingd/clockwork
  2. 2

    Publish the configuration file to enable extra features (Laravel)

    php artisan vendor:publish --provider="Clockwork\Support\Laravel\ClockworkServiceProvider"
  3. 3

    Open the /clockwork route in your app to view collected data

Things to know

  • Clockwork is only active in debug mode by default.
  • This repository is only the server-side component; viewing data also needs the browser extension or the built-in /clockwork interface.
  • Its feature set is strongest for Laravel apps.

In collections

OpenTelemetry & observability platforms

Topics

#php#debugging#profiling#logging#laravel#devtools#clockwork

FAQ

What is clockwork?
A PHP development tool that shows request data, queries, logs, timelines and more in your browser, mainly for Laravel apps. Clockwork is a PHP development tool that gives you visibility into your application at runtime. It collects request data, performance metrics, log entries, database queries, cache and Redis commands, dispatched events, queued jobs, and rendered views for HTTP requests, Artisan commands, queue jobs and tests.
Is clockwork free to use? What license does it have?
clockwork is open source under the MIT license. Check the license terms before using it in commercial products.
Is clockwork still maintained?
Updated within 6 months. The last commit to clockwork was on Aug 29, 2026.
What can I use clockwork for?
Debugging a Laravel application's database queries and performance during development. Inspecting API requests made by a mobile app or frontend without a browser-based debugger. Profiling queue jobs and Artisan commands to see where time is spent. Logging variables inline while tracing a bug in PHP code.
How do I install clockwork?
Install the library with Composer: composer require itsgoingd/clockwork Publish the configuration file to enable extra features (Laravel): php artisan vendor:publish --provider="Clockwork\Support\Laravel\ClockworkServiceProvider" Open the /clockwork route in your app to view collected data
Where can I get clockwork?
The source code and installation instructions are on GitHub: https://github.com/itsgoingd/clockwork

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects