Dump
****

Chaque débogueur est un bon ami de la fonction [php:var_dump], qui affiche en détail le contenu d'une variable. Malheureusement, dans un environnement HTML, l'affichage perd son formatage et se fond en une seule ligne, sans parler de l'assainissement du code HTML. En pratique, il est nécessaire de remplacer `var_dump` par une fonction plus pratique. C'est précisément `dump()`.

```php
$arr = [10, 20.2, true, null, 'hello'];

dump($arr);
// ou Debugger::dump($arr);
```

génère la sortie :

[* dump-basic.webp *]

Vous pouvez changer le thème clair par défaut en thème sombre :

```php
Debugger::$dumpTheme = 'dark';
```

[* dump-dark.webp *]

Nous pouvons également modifier la profondeur d'imbrication à l'aide de [Debugger::$maxDepth |api:Tracy\Debugger::$maxDepth] et la longueur des descriptions affichées à l'aide de [Debugger::$maxLength |api:Tracy\Debugger::$maxLength]. Des valeurs plus basses accéléreront naturellement Tracy.

```php
Debugger::$maxDepth = 2; // default: 3
Debugger::$maxLength = 50; // default: 150
```

La fonction `dump()` peut également afficher d'autres informations utiles. La constante `Tracy\Dumper::LOCATION_SOURCE` ajoute une infobulle avec le chemin vers l'endroit où la fonction a été appelée. `Tracy\Dumper::LOCATION_LINK` nous fournit un lien vers cet endroit. `Tracy\Dumper::LOCATION_CLASS` affiche pour chaque objet dumpé une infobulle avec le chemin vers le fichier où sa classe est définie. Les constantes sont définies dans la variable `Debugger::$showLocation` avant l'appel de `dump()`. Si nous voulons définir plusieurs valeurs à la fois, nous les combinons à l'aide de l'opérateur `|`.

```php
Debugger::$showLocation = Tracy\Dumper::LOCATION_SOURCE; // Définit uniquement l'affichage de l'endroit de l'appel de la fonction
Debugger::$showLocation = Tracy\Dumper::LOCATION_CLASS | Tracy\Dumper::LOCATION_LINK; // Définit à la fois l'affichage du lien et le chemin vers la classe
Debugger::$showLocation = false; // Désactive l'affichage des informations supplémentaires
Debugger::$showLocation = true; // Active l'affichage de toutes les informations supplémentaires
```

Une alternative pratique à `dump()` est `dumpe()` (dump & exit) et `bdump()`. Ce dernier nous permet d'afficher la valeur d'une variable dans le panneau de la barre Tracy. C'est très pratique, car les dumps sont séparés de la mise en page de la page et nous pouvons également y ajouter un commentaire.

```php
bdump([2, 4, 6, 8], 'nombres pairs jusqu\'à dix');
bdump([1, 3, 5, 7, 9], 'nombres impairs jusqu\'à dix');
```

[* bardump-cs.webp *]