Перейти к содержимому
M
Все статьи
Администрирование 8 мин чтения

Отладка Moodle: режим разработчика, логи и как найти причину белого экрана

Как найти причину белого экрана и ошибки 500 в Moodle: порядок диагностики, режим отладки, журналы и таблица «симптом — где смотреть».

Как найти причину белого экрана и ошибки 500 в Moodle: порядок диагностики, режим отладки, журналы и таблица «симптом — где смотреть».

Белый экран в Moodle означает одно: PHP упал, а показать причину не может или не хочет. Само по себе это не диагноз. Причину нужно искать по цепочке: веб-сервер, PHP, конфигурация, база данных, код плагина. Я иду по ней всегда в одном порядке, и ниже — этот порядок, а также как включить отладку, чтобы Moodle сам показывал, где споткнулся. Разбор построен как таблица «симптом — где смотреть» с пояснениями.

Сначала посмотрите на сам ответ сервера

«Белый экран» бывает трёх видов, и они указывают в разные стороны. Если в ответе код 500 и пустое тело, упал PHP, а вывод ошибок выключен. Если код 200 и пустое тело, скрипт завершился без вывода: чаще всего исчерпана память или оборван вывод. Если страница нарисована частично и обрывается, ошибка возникла посреди отрисовки, а часть вывода уже ушла. Код ответа проще всего увидеть командой curl -I https://ваш-сайт/ или во вкладке «Сеть» инструментов браузера.

Симптом — где смотреть

СимптомВероятная причинаГде смотреть
Пустая страница, код 500, сразу после правки config.phpсинтаксическая ошибка, лишний символ перед <?phpжурнал ошибок PHP; проверка командой php -l config.php
«Ошибка подключения к базе данных»база недоступна, неверны параметры, закончились соединенияжурнал сервера базы данных, параметры в config.php, число соединений
Пустая страница после загрузки или обновления плагинафатальная ошибка в коде плагина, несовместимость с версией PHP или Moodleжурнал PHP; временно убрать каталог плагина
Пустая страница на тяжёлой операции (отчёт, восстановление копии)исчерпан memory_limit или max_execution_timeжурнал PHP; лимиты в настройках PHP и веб-сервера
Ошибка 502 или 504PHP-FPM не отвечает или не успел ответить, таймаут проксижурналы веб-сервера и PHP-FPM, число рабочих процессов
Ошибка 403права на файлы или правила веб-серверажурнал веб-сервера, владелец и права каталога
Страница «не дорисована», нет стилейне загрузились JavaScript или стили, устарел кэшконсоль браузера, очистка кэшей
Ошибка «Module not found» или «Class not found»не очищен кэш классов после обновления файловочистить кэши командой php admin/cli/purge_caches.php
Странные ошибки после замены файловOPcache держит старый кодперезапуск PHP-FPM или сброс OPcache
Не работает сайт после переездане совпадают wwwroot, права, расширения PHPвывод php -m и проверка окружения в админке или через CLI

Журналы, которые нужно знать

Расположение журналов зависит от хостинга и ОС. Обычно это журнал ошибок веб-сервера (например, /var/log/nginx/error.log или журнал Apache), журнал PHP-FPM и журнал, который указан в настройке error_log в PHP. Узнать, куда пишет PHP, можно командой:

php -i | grep -E "error_log|display_errors|log_errors"
php -v
php -m | sort

Если вы на виртуальном хостинге без доступа к командной строке, журнал ошибок доступен в панели управления. Важно помнить, что у консольного PHP и у PHP-FPM разные файлы настроек (php.ini), поэтому «в консоли всё нормально» ещё не значит, что в вебе то же самое.

Включение отладки Moodle

В админке: «Администрирование сайта → Разработка → Отладка». Уровень «РАЗРАБОТЧИК» выводит максимум сообщений, включённое «Показывать сообщения отладки» выводит их на страницу. Это удобно на тестовом сайте и нежелательно на рабочем, где посетители увидят пути к файлам.

Если админка недоступна, отладку включают в config.php до строки подключения lib/setup.php:

@error_reporting(E_ALL | E_STRICT);
@ini_set('display_errors', '1');
$CFG->debug = (E_ALL | E_STRICT);
$CFG->debugdisplay = 1;

Часть настроек можно менять из командной строки скриптом admin/cli/cfg.php (параметры --name и --set), что удобно, когда сайт не открывается. После диагностики уровень отладки надо вернуть обратно: оставленный на продакшене режим разработчика замедляет сайт и раскрывает внутренности.

Дополнительные средства

  • Информация о странице. Настройка $CFG->perfdebug со значением 15 и параметр $CFG->debugpageinfo выводят внизу страницы время выполнения, число запросов к базе и использование памяти. Так находят тяжёлые страницы.
  • Режим обслуживания. Команда php admin/cli/maintenance.php --enable закрывает сайт для пользователей на время работ, а --disable снимает блокировку.
  • Дизайнерский режим темы. Включение themedesignermode помогает увидеть правки стилей без кэша; на рабочем сайте его держать нельзя.
  • Журнал событий Moodle. В отчётах администрирования видно, кто и когда заходил и что менял; полезно, когда сбой начался после чьего-то действия.
  • Проверка окружения. Страница «Сервер → Проверка окружения» покажет, какие расширения PHP не хватает.

Типичные сценарии и что в них делала я

Сайт упал после обновления плагина. Самое быстрое действие — переименовать каталог плагина, чтобы Moodle не подхватил его при загрузке. Если страница вернулась, причина в плагине, а дальше читается журнал и проверяется совместимость по версии PHP и ядра (PHP 8 и устаревшие вызовы). Удаление плагина через файловую систему нужно только для диагностики; потом его удаляют штатно через админку, иначе в базе остаются таблицы и настройки.

Сайт упал ночью без вмешательства. Смотрю, не переполнился ли диск (каталог данных и журналы), не закончилась ли память у сервера и не перезапускалась ли база. Именно такая картина была при сбое хостинга в начале ноября 2026: симптомом был белый экран, а причина оказалась вне Moodle. Подробнее о том, как после такого сбоя восстанавливали системы, — в материалах о резервном копировании и технической поддержке Moodle.

Сайт медленный, а не упавший. Это отдельная тема: смотрят число запросов к базе, кэши и работу cron (задачи по расписанию). Общие причины тормозов разобраны в статье почему Moodle тормозит, а выдержит ли сайт пик, показывает нагрузочное тестирование.

Порядок действий, если нет времени разбираться

  1. Зафиксировать время начала сбоя и что делали перед ним.
  2. Открыть журналы веб-сервера и PHP за этот момент.
  3. Проверить место на диске, память, доступность базы.
  4. Включить отладку и повторить действие.
  5. Очистить кэши и перезапустить PHP-FPM.
  6. Отключить последний установленный плагин.

Что передать разработчику, если не получилось самой

Когда белый экран остаётся и нужна внешняя помощь, ценнее всего конкретика. Соберите: версию Moodle и PHP, тип базы данных, время начала сбоя, последнее изменение перед ним (обновление, установка плагина, правка настроек, перенос), фрагмент журнала PHP и веб-сервера за этот момент и ответ на вопрос, воспроизводится ли ошибка на всех страницах или только на одной. С таким набором разбор занимает заметно меньше времени, чем при описании «сайт не открывается». Пароли и ключи из config.php в сообщения не вставляйте: достаточно имён параметров.

Как не допустить повторения

После устранения сбоя запишите, что было причиной, и сделайте так, чтобы следующий раз произошёл тише. Практика, которая у меня прижилась: обновления плагинов сначала на копии; резервная копия базы перед любой установкой; мониторинг доступности сайта с уведомлением; журналы ошибок хранятся и ротируются, чтобы не забить диск; режим разработчика на рабочем сайте выключен, но журнал PHP включён. Мониторинг доступности — отдельная тема, которую я разбирала в статье про оповещения в Telegram и на почту.

Не забыть про права и владельцев

Отдельный класс сбоев возникает после операций, выполненных от имени не того пользователя. Если вы запустили обновление или очистку кэша от root, файлы в каталоге данных и кэше получили владельца root, и веб-сервер больше не может в них писать: страницы падают с ошибкой записи или показывают пустой экран. Диагностика простая: посмотрите владельца файлов в каталоге данных и сравните с пользователем веб-сервера. Исправляется возвратом прав нужному пользователю и очисткой кэшей уже от его имени. Профилактика — всегда запускать команды Moodle через sudo -u с пользователем веб-сервера.

Отладка кода плагина, а не всего сайта

Когда страница уже открывается, но делает не то, режим разработчика недостаточен. В коде плагина помогают три средства. Первое — функция вывода отладочного сообщения Moodle, которая показывается только при включённой отладке и потому безопасна: её можно оставить в коде до выпуска. Второе — исключения: вместо тихого возврата ложного значения выбрасывайте исключение Moodle с понятным кодом строки языкового файла, и администратор получит осмысленное сообщение, а не белый экран. Третье — пошаговый отладчик Xdebug в локальной среде: останов на строке, просмотр переменных и стека вызовов экономят часы по сравнению с вставкой временного вывода. Временный вывод тоже допустим, но его нужно убрать до коммита; страница с забытым var_dump на рабочем сайте выглядит как поломка. Для запросов к базе включите вывод числа запросов на странице и посмотрите, не выполняется ли запрос в цикле: самая частая причина медленных отчётов — десятки одинаковых запросов на каждую строку, которые заменяются одним запросом с объединением.

Если рабочая СДО лежит и нужна помощь прямо сейчас, пишите на срочную помощь программиста.

Нужна помощь с Moodle?

Опишите задачу — расскажу, как решить её конкретно в вашем случае. Свяжитесь — разберём вместе.