Не работает MODX — список распространенных проблем и способов решения

Если MODX перестал работать — не паникуйте. В этой статье собрано большинство распространённых ошибок и proven решений из официальных источников. Подробно разберём: почему не работает админка, белые страницы, проблемы с конфигом и пути в файлах.

1. Ошибка «Could not load MODX config file»

Причины:

Файл core/config/config.inc.php отсутствует или повреждён.
Неправильные пути к файлам в конфигурации.
Неверные права доступа (файл/директория недоступны).

Решения:

Проверьте наличие и права (например, 644) файла config.inc.php.
Убедитесь, что пути внутри файла соответствуют структуре проекта.
При необходимости восстановите файл из бэкапа или повторно запустите установку (/setup/) :contentReference[oaicite:1]{index=1}.

2. Белый экран (White Screen) или пустая админка

Частые причины:

Ошибки PHP — включите отображение ошибок или проверьте логи.
Повреждённый/заполненный кэш.
Проблемы с сессиями или дисковым пространством (например, переполненный диск).

Рекомендации:

Очистите папку core/cache вручную :contentReference[oaicite:2]{index=2}.
Проверьте права на запись в cache, tmp.
Убедитесь, что на диске есть свободное место :contentReference[oaicite:3]{index=3}.

Если админка не загружается даже при верном логине — ошибка регенерации сессии может быть связана с настройками PHP (`session_regenerate_id`) :contentReference[oaicite:4]{index=4}.

3. Проблемы при входе в Manager (ADMIN)

Симптомы: при вводе верных логина/пароля происходит простая перезагрузка страницы.

Что помогает:

Очистка core/cache и удаление анонимных сессий в таблице базы (`anonymous_sessions=1`) :contentReference[oaicite:5]{index=5}.
Проверить права доступа, настройки session, наличие места на диске.

4. Ошибки после свежей установки или обновления

Причины:

Неправильное переименование config.inc.tpl → config.inc.php. Нужно создать пустой, доступный для записи файл, а шаблон оставить .tpl file :contentReference[oaicite:6]{index=6}.
Неверные пути или URL, особенно при установке в поддиректорию — нужно явно прописать RewriteBase в .htaccess :contentReference[oaicite:7]{index=7}.

5. Общие рекомендации по устранению неполадок

Используйте компонент **SiteCheck** для диагностики: он ищет ошибки конфигурации, пути, разрешения файлов и многое другое и может их исправить :contentReference[oaicite:8]{index=8}.
Проверяйте логи: в админке — «Отчёты → Error Log», а на сервере — PHP и Apache/nginx логи :contentReference[oaicite:9]{index=9}.
Следите за синтаксисом сниппетов и чанков — синтаксические ошибки приводят к белому экрану. Используйте IDE с подсветкой, как предлагает MoldStud :contentReference[oaicite:10]{index=10}.
Отключайте плагины/экстрас по очереди, чтобы найти конфликт :contentReference[oaicite:11]{index=11}.

6. Потенциальные проблемы в MODX Cloud

Проверьте статус облака на странице cloud ${MODX} status. Если платформа недоступна — обратитесь в поддержку :contentReference[oaicite:12]{index=12}.
При проблемах с URL или DNS — попытайтесь открыть сайт по прямому internal cloud-адресу, чтобы проверить, в чём проблема :contentReference[oaicite:13]{index=13}.

7. Происходит в Manager: пустое меню, не работают элементы

Сообщается о древней ошибке, когда Manager остаётся пустым даже после входа. Часто в Error Log появляется сообщение о `modAction support is deprecated` — значит, нужно обновить Extra, например, gallery, до актуального routing-based подхода :contentReference[oaicite:14]{index=14}.

Итоги

Когда MODX "не работает", подход должен быть системным:

Проверьте конфиг и логи;
Очистите кэш вручную и проверьте права;
Запустите SiteCheck для автоматической проверки;
Отключите плагины для поиска конфликтов;
Проверьте файлы .htaccess и RewriteBase для поддиректорий;
Если используете Cloud — проверьте status и внутренние адреса.

Если нужна помощь с практическим устранением, пишите — помогу с настройкой, разбором логов и восстановлением работоспособности сайта.

Не работает MODX — как выявить и устранить проблемы