+0
Daily
5,946
stars
331
forks
63
watchers
278
prs
485
issues
101
releases
README
Clockwork is a development tool for PHP available right in your browser. Clockwork gives you an insight into your application runtime - including request data, performance metrics, log entries, database queries, cache queries, redis commands, dispatched events, queued jobs, rendered views and more - for HTTP requests, commands, queue jobs and tests. This repository contains the server-side component of Clockwork. Check out on the Clockwork website for details. Installation Install the Clockwork library via Composer. composer require itsgoingd/clockwork Congratulations, you are done! To enable more features like commands or queue jobs profiling, publish the configuration file via the vendor:publish Artisan command. Note: If you are using the Laravel route cache, you will need to refresh it using the route:cache Artisan command. Read full installation instructions on the Clockwork website. Features Collecting data The Clockwork server-side component collects and stores data about your application. Clockwork is only active when your app is in debug mode by default. You can choose to explicitly enable or disable Clockwork, or even set Clockwork to always collect data without exposing them for further analysis. We collect a whole bunch of useful data by default, but you can enable more features or disable features you don't need in the config file. Some features might allow for advanced options, eg. for database queries you can set a slow query threshold or enable detecting of duplicate (N+1) queries. Check out the config file to see all what Clockwork can do. There are several options that allow you to choose for which requests Clockwork is active. On-demand mode will collect data only when Clockwork app is open. You can even specify a secret to be set in the app settings to collect request. Errors only will record only requests ending with 4xx and 5xx responses. Slow only will collect only requests with responses above the set slow threshold. You can also filter the collected and recorded requests by a custom closure. CORS pre-flight requests will not be collected by default. New in Clockwork 4.1, artisan commands, queue jobs and tests can now also be collected, you need to enable this in the config file. Clockwork also collects stack traces for data like log messages or database queries. Last 10 frames of the trace are collected by default. You can change the frames limit or disable this feature in the configuration file. Viewing data Web interface Visit /clockwork route to view and interact with the collected data. The app will show all executed requests, which is useful when the request is not made by browser, but for example a mobile application you are developing an API for. Browser extension A browser dev tools extension is also available for Chrome and Firefox: - Chrome Web Store - Firefox Addons Toolbar Clockwork now gives you an option to show b
Top issues
#340The WEB UI cannot loading its JS,CSS files13 comments · 2019-07-24#471Feature: Imporve Cache Collector7 comments · 2021-01-16#7235.3.0 is not working with grav CMS6 comments · 2024-11-19#592On Demand not working with Laravel Octane6 comments · 2022-08-08#127Response Tab5 comments · 2016-03-25#747Insane stroage folder size (5gb)4 comments · 2025-09-02#745[Laravel + Sail] Bug: gzdecode(): data error4 comments · 2025-08-20#712request improving filter feature4 comments · 2024-08-04
Latest release
5.2 v5.2.0 2024-02-24- added new security protection - running Clockwork is now restricted to local domains unless explicitly enabled - added Redis storage implementation (implemented by christopherh0rn, thanks!) - added support for collecting tests with Pest 2 and PHPUnit 10 (reported by CadenP, idea by kdevan, thanks!) - added support for all Twig versions in the Twig profiler integration (idea by ericktucto, thanks!) - improved collecting of notifications in Laravel to support latest version of laravel/slack-notification-channel (implemented by maximepvrt, thanks!) - improved Laravel installation process t