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

Дата оновлення перекладу 2025-07-25

Довідник конфігурації налагодження (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 debug
    

Note

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

dump_destination

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

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

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

        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
5
6
7
8
        // config/packages/debug.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

return static function (ContainerConfigurator $container): void {
    $container->extension('debug', [
        'dump_destination' => 'php://stderr',
    ]);
};
    

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

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

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

dump_destination

max_items

max_string_length

min_depth