README

Integrates PHP Debugbar into Flarum 2.x, providing a powerful in-browser debug toolbar for development. Inspect SQL queries, events, routes, authentication, cache operations, mail, and more.

Warning: This is a development tool. Never enable debug mode on production sites.

Installation

composer require datlechin/flarum-debugbar:"*"

Enable the extension in the admin panel, then ensure debug is set to true in your config.php:

'debug' => true,

Publish debugbar assets (usually automatic, but can be done manually):

php flarum debugbar:publish

Features

Debugbar Tabs

Console Commands

php flarum debugbar:publish   # Publish/repair debugbar assets symlink
php flarum debugbar:clear     # Clear stored request history

For Extension Developers

Use DebugbarHelper to log messages and measure performance from your extension code:

use Datlechin\FlarumDebugbar\DebugbarHelper;

// Log messages
DebugbarHelper::info('Loading custom data');
DebugbarHelper::warning('Deprecated method called');
DebugbarHelper::error('Something went wrong');
DebugbarHelper::debug('Variable value: ' . $value);

// Measure execution time
DebugbarHelper::startMeasure('my-operation', 'My Heavy Operation');
// ... do work ...
DebugbarHelper::stopMeasure('my-operation');

// Add exceptions
DebugbarHelper::addException($e);

All methods are safe to call even when the debugbar is disabled, they silently no-op.

Links

• Flarum
• GitHub
• Packagist
• PHP Debugbar