К содержимому

Laravel Debugbar: установка и проверка на Ubuntu 24.04

Laravel Debugbar показывает запросы к базе, переменные и время выполнения прямо в браузере. Панель включается вместе с APP_DEBUG=true, если не задан DEBUGBAR_ENABLED. На рабочем сервере держат APP_DEBUG=false, иначе посетители увидят данные из .env.

Руководство Laravel 2 мин чтения

01Проверьте окружение Laravel

Зайдите в каталог проекта и убедитесь, что Laravel отвечает. Команда php artisan --version покажет версию фреймворка. Для Laravel 13 нужен PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит.

bash
cd /var/www/example.com
php artisan --version
php -v

02Установите пакет Debugbar

Пакет barryvdh/laravel-debugbar ставят через Composer в каталог проекта. Запускайте команду от владельца файлов, без sudo, иначе останутся файлы root, которые PHP-FPM не сможет перезаписать. После установки пакет сам регистрирует сервис-провайдер.

bash
composer require barryvdh/laravel-debugbar --dev

03Включите отладочный режим в.env

Панель включается вместе с APP_DEBUG=true, если переменная DEBUGBAR_ENABLED не задана. Откройте .env и поставьте APP_DEBUG=true. На рабочем сервере этот режим не включают: посетители увидят пароли из .env.

ini
APP_DEBUG=true

04Сбросьте кэш конфига

После правки .env при закэшированном конфиге значения не применяются. Выполните php artisan config:clear, чтобы Laravel перечитал файл. Затем откройте сайт в браузере.

bash
php artisan config:clear

05Проверьте панель в браузере

Откройте страницу сайта. Внизу появится панель Debugbar с вкладками запросов, времени и переменных. Если панели нет, проверьте, что APP_DEBUG=true и DEBUGBAR_ENABLED не задан как false.

06Отключите Debugbar на сервере

На рабочем сайте держат APP_DEBUG=false. При этом Debugbar не работает, и DEBUGBAR_ENABLED=true сам по себе панель не включает. После смены значения выполните php artisan config:clear.

ini
APP_DEBUG=false

Частые ошибки

  • Панель не появляется, хотя пакет установлен.

    Проверьте, что в .env стоит APP_DEBUG=true и не задан DEBUGBAR_ENABLED=false. После правки выполните php artisan config:clear.

  • На рабочем сайте включён APP_DEBUG=true, и Debugbar показывает посетителям данные из .env.

    Поставьте APP_DEBUG=false и выполните php artisan config:clear. При выключенном отладчике Debugbar не работает, и DEBUGBAR_ENABLED=true его не включает.

  • composer require и php artisan падают с Permission denied в bootstrap/cache.

    Запускайте команды без sudo от владельца проекта. Права www-data дают только на storage и bootstrap/cache через группу.

Deploykin

Как это делается в Deploykin

В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Можно ли включить Debugbar при APP_DEBUG=false?

Нет. Пакет проверяет отладочный режим, и DEBUGBAR_ENABLED=true сам по себе панель не включает. На рабочем сервере Debugbar не нужен.

Почему после правки .env панель не появилась?

Конфиг закэширован. Выполните php artisan config:clear, чтобы Laravel перечитал .env.

Где смотреть запросы к базе в Debugbar?

На вкладке Queries внизу страницы. Там видно текст запросов, время выполнения и параметры.

Нужно ли ставить Debugbar на сервер?

Пакет ставят с --dev для разработки. На рабочем сервере его не включают, потому что панель показывает данные из .env.

Ещё по теме

Laravel: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.