Использование отладки
Система отладки Flute CMS помогает быстро выявлять и устранять ошибки в работе сайта. При возникновении проблем (HTTP 500, белые страницы, неожиданное поведение) отладка предоставляет подробную информацию о причинах сбоев.
Режим отладки следует использовать только на этапе разработки или тестирования. На рабочем сайте отладка может раскрыть конфиденциальную информацию посетителям.
Включение через админ-панель
Полная отладка для всех пользователей
Перейдите в Админ-панель → Основные настройки и активируйте переключатель Режим отладки. После сохранения настроек отладочная информация будет отображаться для всех посетителей сайта.
Отладка для конкретных IP-адресов
Для безопасного тестирования на рабочем сайте используйте функцию ограничения по IP-адресам. В поле IP-адреса для отладки укажите адреса через запятую, для которых будет активна отладка.
Чтобы узнать свой IP-адрес, воспользуйтесь сервисом определения IP или посмотрите в Tracy Bar после включения отладки.
Примеры указания IP-адресов:
- Один адрес:
192.168.1.100 - Несколько адресов:
192.168.1.100, 10.0.0.5, 203.0.113.42
Включение через файл конфигурации
Прямое редактирование конфигурации
Если админ-панель недоступна из-за критических ошибок, отладку можно включить напрямую через файл настроек.
Откройте файл configs/app.php в текстовом редакторе и найдите строку с параметром debug. Измените значение на true:
'debug' => true,
После устранения проблем обязательно верните значение debug в false для обеспечения безопасности сайта.
Анализ информации об ошибках
Критические ошибки
При возникновении серьёзных проблем отладчик отображает подробную информацию на весь экран:
- Тип ошибки — категория проблемы (синтаксическая, логическая, системная)
- Сообщение — описание конкретной проблемы
- Файл и строка — точное местоположение ошибки в коде
- Стек вызовов — последовательность выполнения функций до момента ошибки
- Переменные — значения переменных на момент возникновения ошибки
Tracy Bar — панель разработчика
Незначительные предупреждения и полезная информация отображаются в Tracy Bar — специальной панели внизу страницы.
Tracy Bar содержит множество вкладок с технической информацией. Изучение этих данных поможет лучше понять работу системы и оптимизировать производительность.
Практические советы по отладке
Частые причины ошибок
Ошибки базы данных — проверьте настройки подключения в configs/database.php и доступность сервера БД.
Проблемы с правами доступа — убедитесь, что веб-сервер имеет права на запись в папки storage, cache и logs.
Конфликты плагинов — временно отключите недавно установленные расширения для выявления проблемного компонента.
Нехватка памяти — увеличьте лимит памяти PHP в настройках сервера или файле .htaccess.
Логирование ошибок
Flute CMS автоматически сохраняет информацию об ошибках в файлы логов. Найти их можно в папке storage/logs/. Эти файлы полезны для анализа проблем, которые происходили ранее.
Очистка кэша
При странном поведении сайта попробуйте очистить кэш через админ-панель или удалив содержимое папки storage/app/cache/.
Ведите журнал изменений на сайте. Это поможет быстро определить, после каких действий возникла проблема.