Cправочник конфигурации отладки (DebugBundle)

Дата обнволения перевода 2023-01-16

Cправочник конфигурации отладки (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 feature .