Ключи конфигурации¶
Алфавитный указатель всех ключей .bugsaur/config.toml — чтобы найти нужный,
когда имя известно. Сгруппированная версия, с умолчаниями и примерами, лежит в
Настройка → Справочник.
Схема закрытая: ключ, которого нет в этом списке, — ошибка разбора, останавливающая запуск.
| Ключ | Где | Что это |
|---|---|---|
adapter |
[profiles.<имя>] |
id адаптера из каталога. Обязательный |
adapter_command |
[profiles.<имя>] |
перебивает команду адаптера |
args |
[profiles.<имя>] |
аргументы командной строки отлаживаемого процесса |
args |
[profiles.<имя>.build] |
аргументы команды сборки |
bottom |
[ui.layout] |
панели под основной зоной |
bottom_left |
[ui.layout] |
панели нижней левой зоны |
build |
[profiles.<имя>] |
чем собирать перед запуском |
command |
[profiles.<имя>.build] |
исполняемый файл сборки. Обязателен в таблице |
cwd |
[profiles.<имя>] |
рабочий каталог; по умолчанию корень проекта |
default |
верхний уровень | профиль, который берётся без явного имени |
env |
[profiles.<имя>] |
переменные окружения; самый сильный слой |
env_file |
[profiles.<имя>] |
файл с переменными окружения |
keymaps |
[ui] |
хоткеи окна, действие → аккорд |
launch_arguments |
[profiles.<имя>] |
тело DAP, уходит как есть |
launch_timeout |
[profiles.<имя>] |
секунд ожидания ответов на launch / attach и configurationDone |
layout |
[ui] |
раскладка панелей |
left |
[ui.layout] |
доля ширины окна под левую колонку |
left_split |
[ui.layout] |
доля высоты колонки под top_left |
main |
[ui.layout] |
панели основной зоны |
main_split |
[ui.layout] |
доля высоты правой области под main |
mode |
[profiles.<имя>] |
launch или attach |
profiles |
верхний уровень | профили по именам |
program |
[profiles.<имя>] |
что отлаживать. Обязательный |
theme |
[ui] |
dark, light или system |
width |
[ui] |
начальная ширина окна в логических пикселях |
height |
[ui] |
начальная высота окна в логических пикселях |
top_left |
[ui.layout] |
панели верхней левой зоны |
ui |
верхний уровень | настройки окна |
version |
верхний уровень | версия формата конфига. Обязательный |
Значения, которые не являются ключами¶
Имена панелей¶
Используются в [ui.layout], пишутся ровно так, как подписаны вкладки:
Threads · Call Stack · Variables · Watches · Evaluate · Logs ·
Inspector · Breakpoints
Действия для хоткеев¶
Используются в [ui.keymaps]:
| Группа | Действия |
|---|---|
| Выполнение | continue, step_into, step_over, step_out, pause, terminate, restart |
| Панели | next_panel, previous_panel, focus_threads, focus_call_stack, focus_variables, focus_watches, focus_evaluate, focus_logs, focus_inspector, focus_breakpoints |
| Навигация | next_row, previous_row, top, bottom, collapse, expand, activate, delete_row, cancel |
| Поиск по Variables | search, search_next, search_previous, search_continue |
| Прочее | help |
Подстановки¶
| Токен | Во что разворачивается | Где допустим |
|---|---|---|
${root} |
абсолютный путь корня проекта | env, args, adapter_command, launch_arguments |
{out} |
собираемый бинарник | build.args |
{program} |
то, что названо в program |
build.args |
Ключи launch_arguments, которые читает PHP-адаптер¶
| Ключ | Что это |
|---|---|
port |
DBGp-порт для прослушивания; по умолчанию 9003 |
sessionMode |
server или cli; по умолчанию server |
pathMappings |
путь контейнера в путь хоста |
testCommand |
команда запуска PHPUnit для отладки теста под курсором |
Другие адаптеры читают свои ключи; Bugsaur передаёт тело без изменений.