itsgoingd/clockwork
Clockwork
Clockwork is a PHP development debugging tool that collects and displays runtime data from server-side middleware in a browser-based interface. It captures request details, performance metrics, logs, database queries, and stack traces for HTTP requests, commands, queue jobs, and tests without requiring modifications to application code.
The tool provides a client-side rendered toolbar and full web interface for inspecting collected data, including a searchable performance timeline viewer, an HTTP request monitor with timing and response details, and inline variable logging helpers that return values while displaying interactive object trees with stack traces. Clockwork integrates with Xdebug for detailed performance profiling and collects browser navigation timings and Web Vitals to merge with server-side data for full-stack debugging.
Collaborative debugging is supported through a share service that uploads serialized debug data and generates public URLs for team review. The tool transmits data as structured JSON between the server-side collector and browser client, and includes a code execution profiler that measures runtime of code blocks with named timeline events.
Features
- Runtime Debugging Tools - Inspecting and analyzing PHP application runtime data including performance metrics, logs, database queries, and stack traces during development.
- Application Runtime Data Loggers - Collects and stores runtime data including performance metrics, logs, database queries, and stack traces.
- Code Execution Profilers - Measures and visualizes runtime of code blocks with named events and start/end markers on a timeline.
- PHP Runtime Data Collectors - Captures and stores runtime data such as logs, variables, and Xdebug profiles for real-time review in a browser-based interface.
- Inline Expression Debugging - Provides a function that logs its argument and returns it, enabling debugging without breaking expression chains.
- Inline Expression Tracing - Logs and inspects variables directly in PHP code using helper functions that return values while displaying interactive object trees with stack traces.
- Multi-Channel Runtime Inspectors - Collects and displays request data, performance metrics, logs, database queries, and events for HTTP requests, commands, queue jobs, and tests.
- Multi-Context Request Profilers - Collects and visualizes detailed performance timelines, database queries, and stack traces for HTTP requests, commands, and queue jobs.
- Framework Debugging Toolbars - Provides a client-side rendered toolbar showing request information and linking to the full debug interface.
- Client Side Rendering - Renders the debug toolbar and full interface in the browser using JavaScript, processing JSON data into interactive visualizations.
- Application Performance Timelines - Presents a searchable timeline of application execution events, including custom profiling markers and client-side Web Vitals.
- Performance Timeline Recorders - Records and organizes runtime events with start/end markers into a chronological timeline for performance profiling.
- Application Performance Timelines - Presents a searchable visual timeline of all collected runtime data including custom profiling events.
- Multi-Channel Request Profilers - Monitors HTTP requests, commands, queue jobs, and tests with detailed timing, performance timelines, and Xdebug profiling integration.
- Debug Data Inspectors - Provides a browser-based web interface for inspecting collected request and performance data.
- Runtime Data Interceptors - Intercepts HTTP requests, commands, queue jobs, and tests via middleware to capture runtime data without modifying application code.
- Debugging Session Sharing - Uploads serialized debug data to an external service and returns a public URL for collaborative debugging sessions.
- Browser Performance Collectors - Collects browser navigation timings and Web Vitals to complement server-side performance data for full-stack debugging.
- Inline Debugging Loggers - Ships an inline variable logging helper that returns its argument for debugging in expressions.
- Debugger Profiling Controllers - Controls Xdebug profiling sessions programmatically, toggling and retrieving detailed performance profiles from the debugger.
- Outgoing Request Monitors - Displays outgoing HTTP request details with timing and response data alongside server-side debug information.
- Arbitrary Data Type Loggers - Ships a helper function that logs any data type and returns it for inline debugging.
- Browser Navigation Timings Collectors - Collects browser navigation timings and Web Vitals to complement server-side performance data for full-stack debugging.
- HTTP Client Monitoring - Captures and displays outgoing HTTP request details with timing and response data.
- Xdebug Profilers - Integrates with Xdebug to toggle and view detailed performance profiles from the development interface.
- Testing and Debugging - Profiles and debugs applications via browser integration.
