README

A powerful debugging tool for Laravel applications that allows you to monitor and analyze debug data in real-time with advanced filtering and visualization capabilities.

Requirements

PHP ^8.3
Laravel ^12.19

Installation

composer require mohamed_hathout/debugger

Configuration

After installation, publish the configuration file:

php artisan vendor:publish --provider="MohamedHathout\Debugger\DebuggerServiceProvider"

This will publish:

Configuration file (config/debugger.php)
Views (optional)

Usage

Basic Debugging

// Debug any variable
debug($variable);

// Debug an Eloquent query
debug_query($query);

Configuration Options

In config/debugger.php:

return [
    'truncate_tables' => false, // Whether to use TRUNCATE instead of DELETE when clearing data
    'sort' => 'desc', // Sort order for debug entries
    'route_name' => 'debugger', // URL path for the debug viewer
    'is_enabled' => true, // Enable/disable debugging
    'storage_type' => 'database', // 'database' or 'cache'
    
    'cache' => [
        'key_prefix' => 'debugger:',
        'counter_key' => 'debugger:counter',
        'index_key' => 'debugger:index',
        'files_key' => 'debugger:files',
        'ttl' => 3600, // Cache TTL in seconds
    ],
];

Debug Viewer

Access the debug viewer at /debugger (or your configured route) to see all debug entries with:

Real-time updates
Type filtering (text, number, JSON)
File filtering
Search functionality
Copy to clipboard
Clear all data

Features

Debug any variable type (text, numbers, arrays, objects)
Query debugging with bindings resolution
Real-time debug viewer with Livewire
Advanced filtering and search
Database or cache storage options
Configurable settings
Bootstrap 5 UI with dark mode support

License

The MIT License (MIT).

mohamed-hathout / debugger

Maintainers

Details