astral-php / astral-debug

0.1.0 2026-10-08 14:42 UTC

Requires

• php: ^8.1
• astral-php/astral-core: ^1.2

Requires (Dev)

• phpunit/phpunit: ^10.0 || ^11.0

MIT

• astral-php

• php
• debug
• toolbar
• DX
• astral

Published on Packagist.org on 2026-10-08 14:49 UTC

README

Barre de debug pour Astral — temps, mémoire, SQL, messages. Dev uniquement.

dump() / dd() sont déjà fournis par astral-core. Ce package ajoute une toolbar HTML.

Prérequis

Dépendance	Version
PHP	^8.1
astral-php/astral-core	^1.2

Installation

composer require astral-php/astral-debug --dev

1. Service provider

Dans config/dependencies.php :

AstralDebug\DebugServiceProvider::class,

2. Middleware

Appliquer globalement (ou sur les routes HTML) :

use AstralDebug\Middleware\DebugBarMiddleware;

// Exemple : groupe racine / middleware global selon votre Router
$router->get('/', HomeController::class, 'index')
    ->middleware(DebugBarMiddleware::class);

3. Environnement

APP_ENV=local
APP_DEBUG=true

Désactivé automatiquement si APP_DEBUG=false ou APP_ENV=production.

Usage

use AstralDebug\Collector;

$collector = $container->make(Collector::class);
$collector->addQuery('SELECT * FROM users WHERE id = ?', 1.2, [1]);
$collector->addMessage('Cache miss on homepage', 'warning');

Tests

composer test

Compatibilité

astral-core	PHP	astral-debug
^1.2	8.1 → 8.4	0.x

Licence

MIT — voir LICENSE