Довідник конфігурації налагодження (DebugBundle)

Дата оновлення перекладу 2022-12-16

Довідник конфігурації налагодження (DebugBundle)

DebugBundle інтегрує компонент VarDumper у додатки Symfony. Всі ці опції сконфігуровані під ключем debug у конфігурації вашого додатку.

        1
2
3
4
5
6
7
8
9
        # відображає значення конфігурації, визначені Symfony за замовчуванням
$ php bin/console config:dump-reference debug

# відображає реальні значення конфігурації, використовувані вашим додатком
$ php bin/console debug:config debug

# відображає значення конфігурації, використовувані вашим додатком та заміняє
# змінні середовища на їх реальні значення
$ php bin/console debug:config --resolve-env framework
    

6.2

Опція --resolve-env була представлена в Symfony 6.2.

Note

При використанні XML, ви повинні використовувати простір імен http://symfony.com/schema/dic/debug і відповідну схему XSD, доступну за посиланням: https://symfony.com/schema/dic/debug/debug-1.0.xsd

Конфігурація

max_items

тип: integer за замовчуванням: 2500

Це максимальна кількість предметів для скидання. Установка цієї опції як -1 відключає обмеження.

min_depth

тип: integer за замовчуванням: 1

Конфігурує мінімальну глибину дерева, до якої всі обʼєкти гарантовано будуть клоновані. Після досягнення цієї глибини, лише обʼєкти max_items будуть клоновані. Значення за замовчуванням 1, що відповідає старішим версіям Symfony.

max_string_length

тип: integer за замовчуванням: -1

Ця опція конфігурує максимальну довжину рядку перед тим, як обрізати його. Значення за замовчуванням (-1) означає, що рядки ніколи не обрізаються.

dump_destination

тип: string за замовчуванням: null

Конфігурує точку призначення виведення скидань.

За замовчуванням, скидання відображаються у панелі інструментів веб-налагодження, при поверненні XML. Так як це не завжди можливо (наприклад, при роботі з JSON API), то у вас може бути альтернативна точка призначення для скидань. Зазвичай вона встановлюється як php://stderr:

YAML
XML
PHP

        1
2
3
        # config/packages/debug.yaml
debug:
    dump_destination: php://stderr
    

        1
2
3
4
5
6
7
8
9
10
11
        <!-- config/packages/debug.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/debug"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:debug="http://symfony.com/schema/dic/debug"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd
        http://symfony.com/schema/dic/debug https://symfony.com/schema/dic/debug/debug-1.0.xsd">

    <debug:config dump-destination="php://stderr"/>
</container>
    

        1
2
3
4
        // config/packages/debug.php
$container->loadFromExtension('debug', [
    'dump_destination' => 'php://stderr',
]);
    

Сконфігуруйте її як "tcp://%env(VAR_DUMPER_SERVER)%", щоб використовувати функцію ServerDumper .