Белый экран в 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 или 504 | PHP-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 тормозит, а выдержит ли сайт пик, показывает нагрузочное тестирование.
Порядок действий, если нет времени разбираться
- Зафиксировать время начала сбоя и что делали перед ним.
- Открыть журналы веб-сервера и PHP за этот момент.
- Проверить место на диске, память, доступность базы.
- Включить отладку и повторить действие.
- Очистить кэши и перезапустить PHP-FPM.
- Отключить последний установленный плагин.
Что передать разработчику, если не получилось самой
Когда белый экран остаётся и нужна внешняя помощь, ценнее всего конкретика. Соберите: версию Moodle и PHP, тип базы данных, время начала сбоя, последнее изменение перед ним (обновление, установка плагина, правка настроек, перенос), фрагмент журнала PHP и веб-сервера за этот момент и ответ на вопрос, воспроизводится ли ошибка на всех страницах или только на одной. С таким набором разбор занимает заметно меньше времени, чем при описании «сайт не открывается». Пароли и ключи из config.php в сообщения не вставляйте: достаточно имён параметров.
Как не допустить повторения
После устранения сбоя запишите, что было причиной, и сделайте так, чтобы следующий раз произошёл тише. Практика, которая у меня прижилась: обновления плагинов сначала на копии; резервная копия базы перед любой установкой; мониторинг доступности сайта с уведомлением; журналы ошибок хранятся и ротируются, чтобы не забить диск; режим разработчика на рабочем сайте выключен, но журнал PHP включён. Мониторинг доступности — отдельная тема, которую я разбирала в статье про оповещения в Telegram и на почту.
Не забыть про права и владельцев
Отдельный класс сбоев возникает после операций, выполненных от имени не того пользователя. Если вы запустили обновление или очистку кэша от root, файлы в каталоге данных и кэше получили владельца root, и веб-сервер больше не может в них писать: страницы падают с ошибкой записи или показывают пустой экран. Диагностика простая: посмотрите владельца файлов в каталоге данных и сравните с пользователем веб-сервера. Исправляется возвратом прав нужному пользователю и очисткой кэшей уже от его имени. Профилактика — всегда запускать команды Moodle через sudo -u с пользователем веб-сервера.
Отладка кода плагина, а не всего сайта
Когда страница уже открывается, но делает не то, режим разработчика недостаточен. В коде плагина помогают три средства. Первое — функция вывода отладочного сообщения Moodle, которая показывается только при включённой отладке и потому безопасна: её можно оставить в коде до выпуска. Второе — исключения: вместо тихого возврата ложного значения выбрасывайте исключение Moodle с понятным кодом строки языкового файла, и администратор получит осмысленное сообщение, а не белый экран. Третье — пошаговый отладчик Xdebug в локальной среде: останов на строке, просмотр переменных и стека вызовов экономят часы по сравнению с вставкой временного вывода. Временный вывод тоже допустим, но его нужно убрать до коммита; страница с забытым var_dump на рабочем сайте выглядит как поломка. Для запросов к базе включите вывод числа запросов на странице и посмотрите, не выполняется ли запрос в цикле: самая частая причина медленных отчётов — десятки одинаковых запросов на каждую строку, которые заменяются одним запросом с объединением.
Если рабочая СДО лежит и нужна помощь прямо сейчас, пишите на срочную помощь программиста.
Опишите задачу — расскажу, как решить её конкретно в вашем случае. Свяжитесь — разберём вместе.