Самосвал
********

Всеки дебъгер е запознат с функцията `var_dump`, която подробно изброява цялото съдържание на всяка променлива. За съжаление, изходът му не е форматиран в HTML и извежда изхвърлянето на данни в един ред HTML код, без да се споменава ескапирането на контекста. Трябва да заменим `var_dump` с по-удобна функция. Точно това е функцията `dump()`.

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

dump($arr);
// или Debugger::dump($arr);
```

генерира изхода:

[* dump-basic.webp *]

Можете да промените светлата тема по подразбиране в тъмна:

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

[* dump-dark.webp *]

Можете също така да промените дълбочината на вмъкване на `Debugger::$maxDepth` и дължината на показваните редове на `Debugger::$maxLength`. Естествено, по-малките стойности ускоряват изобразяването на Трейси.

```php
Debugger::$maxDepth = 2; // по подразбиране: 3
Debugger::$maxLength = 50; // по подразбиране: 150
```

Функцията `dump()` може да показва и друга полезна информация. `Tracy\Dumper::LOCATION_SOURCE` добавя подсказка с пътя до файла, в който е извикана функцията. `Tracy\Dumper::LOCATION_LINK` добавя връзка към файла. `Tracy\Dumper::LOCATION_CLASS` добавя подсказка към всеки обект за изхвърляне, съдържаща пътя до файла, в който е дефиниран класът на обекта. Всички тези константи могат да бъдат зададени в променливата `Debugger::$showLocation`, преди да се извика функцията `dump()`. Можете да зададете няколко стойности едновременно, като използвате оператора `|`.

```php
Debugger::$showLocation = Tracy\Dumper::LOCATION_SOURCE; // Показва пътя до мястото, където е извикан dump()
Debugger::$showLocation = Tracy\Dumper::LOCATION_CLASS | Tracy\Dumper::LOCATION_LINK; // Показва както пътя до класовете, така и връзката към мястото, където е извикан dump()
Debugger::$showLocation = false; // Скрива допълнителна информация за местоположението
Debugger::$showLocation = true; // Показва цялата допълнителна информация за местоположението
```

Много удобна алтернатива на `dump()` са `dumpe()` (т.е. dump and exit) и `bdump()`. Това ни позволява да въвеждаме променливи в лентата Tracy Bar. Това е полезно, тъй като дамп-ите не развалят изхода, а и можем да добавим заглавие към дамп-а.

```php
bdump([2, 4, 6, 8], 'even numbers up to ten');
bdump([1, 3, 5, 7, 9], 'odd numbers up to ten');
```

[* bardump-en.webp *]