debugflow/laravel

Laravel driver for DebugFlow debugging tool

dev-main 2026-02-03 05:16 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0
• ramsey/uuid: ^4.0

MIT

• Anand Pilania

README

DebugFlow Laravel Driver

Laravel driver for DebugFlow debugging tool.

Installation

composer require debugflow/laravel

Configuration

Publish the config file:

php artisan vendor:publish --tag=debugflow-config

Add to your .env:

DEBUGFLOW_ENABLED=true
DEBUGFLOW_HOST=localhost
DEBUGFLOW_PORT=23518
DEBUGFLOW_QUERIES=true
DEBUGFLOW_EXCEPTIONS=false

Usage

Using the Facade

use DebugFlow\Facades\DebugFlow;

DebugFlow::log('Hello from Laravel!');
DebugFlow::dump($user);
DebugFlow::query('SELECT * FROM users', []);
DebugFlow::exception($e);

Using Helper Functions

df('Quick debug');
df($user)->green()->label('User Data');

ray($data)->purple()->tag('api');

Chainable Methods

df($user)
    ->green()
    ->label('User Object')
    ->large()
    ->tag('user', 'important');

Measure Performance

$result = df()->measure('api-call', function() {
    return Http::get('https://api.example.com');
});

Auto-Capturing

Queries are automatically captured when DEBUGFLOW_QUERIES=true:

User::where('active', true)->get();

Available Methods

• log($content) - Log message
• dump($content) - Dump variable
• query($sql, $bindings, $time) - Log query
• exception($exception) - Log exception
• measure($name, $callback) - Measure performance
• http($request, $response) - Log HTTP
• event($name, $payload) - Log event

Colors

• red()
• orange()
• yellow()
• green()
• blue()
• purple()
• gray()
• pink()

Sizes

• large()
• small()

Requirements

• PHP 8.1+
• Laravel 9.0+