Laravel Debugbar v4.0.0 is released

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

• Upgrade Docs
• Full Changelog
• GitHub Repository