https://picperf.io/https://laravelnews.s3.amazonaws.com/featured-images/laravel-debugbar-v4.png
Release Date: January 23, 2025
Package Version: v4.0.0
Summary
Laravel Debugbar v4.0.0 marks a major release with package ownership transferring from barryvdh/laravel-debugbar to fruitcake/laravel-debugbar. This version brings php-debugbar 3.x support and includes several new collectors and improvements for modern Laravel applications.
- HTTP Client collector for tracking outbound API requests
- Inertia collector for Inertia.js data tracking
- Improved Livewire support for versions 2, 3, and 4
- Remove jQuery in favor of modern JS
- Improved performance and delayed rendering
- Laravel Octane compatibility for long-running processes
- And more
What’s New
HTTP Client Collector
This release adds a new collector that tracks HTTP client requests made through Laravel’s HTTP client. The collector provides visibility into outbound API calls, making it easier to debug external service integrations and monitor response times.
Inertia Collector
For applications using Inertia.js, the new Inertia collector tracks shared data and props passed to Inertia components. This helps debug data flow in Inertia-powered applications.
Enhanced Livewire Support
The debugbar now includes improved component detection for Livewire versions 2, 3, and 4. This provides better visibility into Livewire component lifecycle events and data updates across all currently supported Livewire versions.
Laravel Octane Compatibility
This version includes better handling for Laravel Octane and other long-running server processes. The debugbar now properly manages state across requests in persistent application environments.
Cache Usage Estimation
The cache widget now displays estimated byte usage, giving developers better insight into cache memory consumption during request processing.
Debugbar Position and Themes
This version has many UI improvements and settings like debugbar position, auto-hiding empty collectors, themes (Dark, Light, Auto), and more:
Breaking Changes
Package Ownership and Installation
The package has moved from barryvdh/laravel-debugbar to fruitcake/laravel-debugbar, requiring manual removal and reinstallation:
composer remove barryvdh/laravel-debugbar --dev --no-scripts
composer require fruitcake/laravel-debugbar --dev --with-dependencies
The namespace has changed from the original structure to Fruitcake\LaravelDebugbar. You’ll need to update any direct references to debugbar classes in your codebase.
Removed Features
Several features have been removed in this major version:
- Socket storage support has been removed
- Lumen framework support is no longer included
- PDO extension functionality has been dropped
Configuration Changes
Default configuration values have been updated, and deprecated configuration options have been removed. Review your config/debugbar.php file and compare it with the published configuration from the new package.
Upgrade Notes
This is not a standard upgrade. You must manually remove the old package and install the new one using the commands shown above. After installation, update any namespace references in your code from the old barryvdh namespace to Fruitcake\LaravelDebugbar.
Review your configuration file for deprecated options and compare with the new defaults. The package maintains compatibility with Laravel 9.x through 12.x. See the upgrade docs for details on upgrading from 3.x to 4.x.
References
Laravel News