Laravel Debugbar: установка и проверка на Ubuntu 24.04
Laravel Debugbar показывает запросы к базе, переменные и время выполнения прямо в браузере. Панель включается вместе с APP_DEBUG=true, если не задан DEBUGBAR_ENABLED. На рабочем сервере держат APP_DEBUG=false, иначе посетители увидят данные из .env.
01Проверьте окружение Laravel
Зайдите в каталог проекта и убедитесь, что Laravel отвечает. Команда php artisan --version покажет версию фреймворка. Для Laravel 13 нужен PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит.
cd /var/www/example.com
php artisan --version
php -v
02Установите пакет Debugbar
Пакет barryvdh/laravel-debugbar ставят через Composer в каталог проекта. Запускайте команду от владельца файлов, без sudo, иначе останутся файлы root, которые PHP-FPM не сможет перезаписать. После установки пакет сам регистрирует сервис-провайдер.
composer require barryvdh/laravel-debugbar --dev
03Включите отладочный режим в.env
Панель включается вместе с APP_DEBUG=true, если переменная DEBUGBAR_ENABLED не задана. Откройте .env и поставьте APP_DEBUG=true. На рабочем сервере этот режим не включают: посетители увидят пароли из .env.
APP_DEBUG=true
04Сбросьте кэш конфига
После правки .env при закэшированном конфиге значения не применяются. Выполните php artisan config:clear, чтобы Laravel перечитал файл. Затем откройте сайт в браузере.
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.
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 PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы