php-debugbar/php-debugbar
Php Debugbar
This project is a PHP debugging toolbar and runtime inspector that provides a browser-based interface for monitoring system metrics, memory usage, and execution time during web development. It functions as an application performance monitor and diagnostic tool, capturing real-time data and application state to visualize the PHP execution lifecycle.
The tool distinguishes itself through its ability to persist debug data across multiple requests, allowing for request history tracking and the archival of previous sessions. It supports the inspection of AJAX requests and manages data persistence during redirects to ensure diagnostic information is available across asynchronous and sequential page loads.
The system covers broad observability capabilities including automated runtime metric collection, custom message logging, and the rendering of complex variables as interactive HTML dumps. It utilizes a modular architecture with collectors for data aggregation, driver-based HTTP abstraction, and an interface-driven storage system for managing how debug data is written and retrieved.
The toolbar is integrated into web pages via late-binding asset injection of JavaScript and HTML.
Features
- PHP Application Debuggers - Provides a browser-based interface for monitoring real-time system metrics and application state during the development process.
- Browser Debugging Toolbars - Implements a browser-based diagnostic toolbar for inspecting AJAX requests and application state.
- Data Persistence and Storage - Saves collected application data to external storage, such as files or databases, for analysis across multiple requests.
- PHP Runtime Data Collectors - Captures and stores runtime data such as logs and variables for real-time review in a browser-based interface.
- Runtime Variable Inspectors - Provides a comprehensive system for collecting and persisting PHP environment data and runtime variables across requests.
- Framework Debugging Toolbars - Ships a browser-integrated toolbar that captures and displays real-time PHP application metrics, memory usage, and execution time.
- Runtime Performance Profiling - Tracks memory usage, execution time, and database queries to identify performance bottlenecks in a PHP environment.
- Runtime State Visualizers - Displays real-time system information and application data in a browser-based bar for development.
- Debug Data Visualizers - Renders a browser-based interface showing real-time system information and request metrics.
- Custom Metric Collectors - Enables the creation of custom collectors to capture specific runtime metrics and define associated interface widgets.
- System Metrics Collection - Collects native system-level performance metrics, database queries, and memory usage.
- Metric Collection - Gathers quantitative performance data including memory usage and execution time.
- Request History Archives - Saves and retrieves data from previous requests to compare performance or debug recurring issues across sessions.
- Asset Injection - Injects JavaScript and HTML into the final page output to render the debug toolbar without modifying application templates.
- Cross-Request Debug Persistence - Stores collected debug data in a session or storage mechanism to be displayed after a redirect.
- Debug Session Managers - Stores and switches between different sets of debugging data to toggle the viewed context.
- Debug History Retrievers - Opens and displays previously stored sets of collected application data via a dedicated URL handler.
- AJAX Debug Data Polling - Retrieves debug information for AJAX requests by fetching stored data via a dedicated server-side handler.
- HTTP Session and Header Abstractions - Provides a driver interface to manage sessions and headers across different environments, removing reliance on native language mechanisms.
- Custom Storage Handlers - Supports implementing custom storage handlers through a defined interface to control how debug data is written and retrieved.
- Driver-Based Service Abstractions - Employs a driver interface to decouple HTTP header and session management from the native PHP global state.
- Request-to-Debug-Data Mappings - Assigns unique lexically ordered identifiers to requests to map stored debug data to specific browser sessions.
- Storage Abstractions - Defines a common storage interface to decouple debug data persistence from the underlying file system or database.
- Application Performance Monitoring - Provides a development tool for visualizing system metrics, database queries, and request data during the PHP execution lifecycle.
- Custom Debug Logging - Enables adding manual text messages to the debug interface to track application flow and state changes.
- Application Diagnostics - Visualizes complex variables and application state through interactive HTML dumps and custom data collectors.
- Observability Data Aggregators - Aggregates real-time system and application metrics via modular collectors for unified display.
- Debug Widget Mappings - Links collected data sets to specific browser interface components through a configurable mapping of tabs and icons.
- Interactive Variable Dumps - Converts complex variables into interactive, searchable HTML dumps with configurable depth.
- AJAX Debug Data Transport - Sends debug information via headers or storage handlers to be displayed during asynchronous requests.
- AJAX Request Diagnostics - Captures and displays debugging information for asynchronous requests to ensure background processes function.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
