Использование отладки

Система отладки Flute CMS помогает быстро выявлять и устранять ошибки в работе сайта. При возникновении проблем (HTTP 500, белые страницы, неожиданное поведение) отладка предоставляет подробную информацию о причинах сбоев.

Что даёт режим отладки:

• Вместо стандартных страниц с ошибками вы увидите подробное описание проблемы: файл, строку кода, стек вызовов
• Внизу каждой страницы появится Tracy Bar — панель разработчика с информацией о времени загрузки, SQL-запросах, использовании памяти и многом другом
• Логи ошибок будут записываться максимально подробно

Когда использовать:

• Сайт показывает белую страницу или ошибку 500
• Что-то работает не так, как ожидалось (например, не сохраняются настройки, не загружаются страницы)
• Вы разрабатываете или тестируете модуль/тему

Включение через админ-панель

Полная отладка для всех пользователей

1. В боковом меню админ-панели, в разделе “Основное”, нажмите на пункт “Основные настройки”
2. Вы окажетесь на вкладке “Основные настройки”
3. Прокрутите страницу вниз до секции “Настройки отладки”
4. Включите переключатель “Режим отладки”
5. Сохраните настройки

После сохранения отладочная информация будет отображаться для всех посетителей сайта.

Отладка для конкретных IP-адресов

Для безопасного тестирования на рабочем сайте используйте функцию ограничения по IP-адресам. В той же секции “Настройки отладки” найдите поле “IP-адреса для отладки” и укажите адреса через запятую, для которых будет активна отладка.

Примеры указания IP-адресов:

• Один адрес: 192.168.1.100
• Несколько адресов: 192.168.1.100, 10.0.0.5, 203.0.113.42

Включение через файл конфигурации

Прямое редактирование конфигурации

Если админ-панель недоступна из-за критических ошибок, отладку можно включить напрямую через файл настроек.

Откройте файл configs/app.php в текстовом редакторе и найдите строку с параметром debug. Измените значение на true:

'debug' => true,

Анализ информации об ошибках

Критические ошибки

При возникновении серьёзных проблем отладчик отображает подробную информацию на весь экран:

• Тип ошибки — категория проблемы (синтаксическая, логическая, системная)
• Сообщение — описание конкретной проблемы
• Файл и строка — точное местоположение ошибки в коде
• Стек вызовов — последовательность выполнения функций до момента ошибки
• Переменные — значения переменных на момент возникновения ошибки

Tracy Bar — панель разработчика

Когда режим отладки включён, внизу каждой страницы появляется Tracy Bar — специальная панель с технической информацией. Она показывает:

• Время загрузки страницы — сколько миллисекунд заняла генерация
• Использование памяти — объём оперативной памяти, который потребовался для обработки запроса
• SQL-запросы — список всех запросов к базе данных, их количество и время выполнения
• Предупреждения — незначительные ошибки и предупреждения, которые не вызывают сбой, но могут указывать на потенциальные проблемы
• Ваш IP-адрес — полезно, если нужно узнать свой IP для настройки отладки по IP

Нажимая на отдельные вкладки Tracy Bar, можно раскрыть подробную информацию по каждому разделу.

Практические советы по отладке

Частые причины ошибок

Ошибки базы данных — проверьте настройки подключения в configs/database.php и доступность сервера БД.

Проблемы с правами доступа — убедитесь, что веб-сервер имеет права на запись в папки storage, cache и logs.

Конфликты плагинов — временно отключите недавно установленные расширения для выявления проблемного компонента.

Нехватка памяти — увеличьте лимит памяти PHP в настройках сервера или файле .htaccess.

Логирование ошибок

Flute CMS автоматически сохраняет информацию об ошибках в файлы логов. Найти их можно в папке storage/logs/. Эти файлы полезны для анализа проблем, которые происходили ранее.

Очистка кэша

При странном поведении сайта попробуйте очистить кэш через админ-панель или удалив содержимое папки storage/app/cache/.