News

PHP DebugBar v3 is released

Published
PHP DebugBar v3 is released image

Barry vd. Heuvel just announced that PHP DebugBar v3 is now released and the Laravel Debugbar will follow soon.

New Php DebugBar features:

  • Modernize Javascript, removed jQuery
  • New Tabler icons with build script, replaces heavy FontAwesome with minimal SVG icons
  • Build scripts for prefixed dependencies and minimized assets
  • New AssetHandler to make to make it easier to dump assets into your own project
  • Improved contrast for Light mode
  • Option to render the debugbar on top instead of bottom
  • Render widget on open to reduce initial page load time
  • Improved TimelineData support to other collectors
  • Backtrace support for QueryCollector
  • Static analysis with phpstan/eslint, typehints everywhere
  • Added Symfony HttpFoundation Request collector (with bridge)
  • Improved performance and a lot more tweaks.

Breaking Changes to Know About

This is a major version for a reason. If you have custom collectors, widgets, or deep integration, expect adjustments:

Widgets and UI

  • jQuery is removed, and widgets are now Javascript classes. Custom widgets should be updated.
  • FontAwesome is removed, and replaced by SVG icons from Tabler, included in CSS. Only the icons used by the default widgets are included, so packages extending the debugbar should add their own icons.
  • Typehints are added to all widgets, so you might need to update your widgets.
  • Widgets are rendered when opening a tab, not when loading the page.

Changes to DataCollectors

  • TimeDataCollector is removed from the constructors, but a setTimeDataCollector method is added.
  • useHtmlVarDumper is removed. The HtmlDataFormatter is used by default. To use plain-text, the the default formatter to DataFormatter.
  • Remove obsolete methods
  • Removed get/setBindAjaxHandlerToJquery (Use bind to fetch/xhr instead)
  • Removed Assetic collection (use getAssets() directly if needed)
  • Removed RequireJS support
  • Removed captureVar and renderCapturedVar from DebugBarVarDumper
  • Breaking changes to methods/interfaces
  • Everything is typehinted, so you might need to update your code for custom collectors.
  • getAssets() removed the $type parameter and always returns all assets.
  • OpenHandler requires the op parameter to be always set.
  • The DataFormatterInterface has a 2nd 'deep' parameter to formatVar.
  • The StorageInterface has a new 'prune' method

View the complete release announcement on GitHub

Eric L. Barnes photo

Eric is the creator of Laravel News and has been covering Laravel since 2012.

Filed in

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article