MODX на сервере: частые ошибки и решения

MAATRIX

MODX Revolution гибок и надёжен, но на сервере у него свой набор типичных проблем: белый экран, ошибка соединения с базой, не открывается менеджер, зависший кэш после правок, 500 при включении дружественных URL или сбои прав доступа. Практически все частые ошибки MODX объясняются понятными причинами — PHP, база, кэш, конфиг веб-сервера, права — и решаются проверенным набором действий. Разберём их по порядку, начиная с самых частых, с командами и указанием, где искать логи. Где искать причины. Ошибки PHP пишутся в лог веб-сервера: /var/log/apache2/error.log или /var/log/nginx/error.log. У MODX есть собственный журнал ошибок в менеджере (Отчёты → Журнал ошибок) и файл core/cache/logs/error.log. Ключевая особенность MODX — агрессивное кэширование: очень многие «внезапные» сбои снимаются простой очисткой кэша. Поэтому первый рефлекс при странном поведении сайта после изменений — очистить кэш, и только если не помогло, копать глубже по логам. Стоит понимать общую картину, чтобы диагностировать быстрее. Запрос к странице MODX проходит через веб-сервер к ядру, которое либо отдаёт готовую страницу из кэша, либо собирает её заново из шаблона, чанков и сниппетов, обращаясь к базе. Отсюда логика поиска: если сайт отдаёт устаревший контент — виноват кэш; если падает с фатальной ошибкой — смотрим PHP и сниппеты; если вообще не подключается — база или конфиг; если ломаются адреса страниц — правила перезаписи и настройки URL. Определив, на каком этапе рвётся сборка страницы, вы сразу сужаете круг поиска и не тратите время на исправные компоненты.

Белый экран после правок или обновления

Сайт открывается пустой белой страницей — типичная ситуация для MODX после изменения шаблона, установки дополнения или обновления. В большинстве случаев виноват устаревший или битый кэш. Первое средство — очистить кэш. Если менеджер доступен, сделайте это через меню (Управление → Очистить кэш). Если менеджер тоже не открывается, удалите кэш через SSH:

rm -rf /var/www/vashdomen.ru/core/cache/*

После очистки MODX пересоберёт кэш при следующем обращении. Если белый экран остался, дело в фатальной ошибке PHP: включите отображение ошибок, отредактировав конфиг ядра core/config/config.inc.php или настройки PHP, и обновите страницу — появится текст с указанием файла и строки. Частая причина — нехватка памяти PHP: увеличьте memory_limit до 256M и перезапустите веб-сервер (systemctl restart apache2).

Ошибка соединения с базой данных

MODX не подключается к базе. Проверьте параметры подключения в конфигурационном файле core/config/config.inc.php — там прописаны хост, имя базы, пользователь, пароль и префикс таблиц. Опечатка или смена пароля пользователя базы — частая причина. Проверьте, запущена ли СУБД:

systemctl status mysql

Если сервис не запущен — стартуйте и смотрите причину падения. Очень частая скрытая причина — переполненный диск, из-за которого база уходит в режим только для чтения:

df -h

Почистите старые бэкапы, логи и кэш. MODX хранит объёмный кэш; после сбоя базы восстанавливайте таблицы средствами MySQL и из резервной копии. Регулярные повреждения базы — признак нестабильного диска или частых внезапных отключений, что на надёжном VPS редкость.

Не открывается менеджер (админка)

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

chown -R www-data:www-data /var/www/vashdomen.ru

Третье — если вы переименовывали каталог manager для безопасности, убедитесь, что в конфиге ядра обновлён путь к менеджеру (MODX_MANAGER_PATH и связанные URL-константы). Рассогласование пути и настроек — частая причина недоступности админки. Если забыт пароль администратора, его можно сбросить через утилиту MODX в каталоге core/ или напрямую в базе, но аккуратно и с бэкапом.

Ошибка 500 при включении дружественных URL

Включили friendly URLs, и сайт стал отдавать 500 или ссылки перестали работать. Причина — не активирован модуль перезаписи Apache или отсутствует .htaccess. Убедитесь, что rewrite включён:

a2enmod rewrite
systemctl restart apache2

MODX поставляет файл правил как ht.access — переименуйте его в .htaccess в корне сайта:

mv /var/www/vashdomen.ru/ht.access /var/www/vashdomen.ru/.htaccess

Также в конфиге виртуального хоста должно стоять AllowOverride All, иначе .htaccess игнорируется. Проверьте, что в настройках MODX корректно задан site_url и включена friendly_urls. На Nginx правила перезаписи задаются в его конфиге отдельным блоком, а не через .htaccess. После исправления очистите кэш и проверьте ссылки.

Проблемы с правами и установкой дополнений

MODX не устанавливает дополнения из репозитория, не сохраняет ресурсы или пишет об ошибках записи — проблема с правами. Владельцем каталога сайта должен быть www-data. Особое внимание к каталогам, куда MODX пишет: core/cache/, core/packages/, core/config/ и assets/. Восстановите владельца и корректные права:

chown -R www-data:www-data /var/www/vashdomen.ru
find /var/www/vashdomen.ru -type d -exec chmod 755 {} \;
find /var/www/vashdomen.ru -type f -exec chmod 644 {} \;

Ещё одна причина, по которой не ставятся дополнения, — нет исходящего доступа к репозиторию MODX или не хватает расширения php-zip для распаковки пакетов. Проверьте, что сервер имеет доступ в интернет и php-zip установлен. После установки дополнений очищайте кэш.

Нехватка ресурсов и медленная работа

MODX нетребователен, но при большом сайте, тяжёлых сниппетах и высоком трафике ресурсы всё же нужны. Если сайт тормозит, проверьте память:

free -m

Если система в свопе — серверу мало RAM. Убедитесь, что кэширование работает: MODX кэширует страницы и элементы, и правильно настроенный кэш резко снижает нагрузку. Тяжёлые сниппеты без кэширования (например, вывод больших списков без pdoTools с кэшем) нагружают сервер на каждый запрос — оптимизируйте их. Если после оптимизации сайт всё равно упирается в ресурсы, нужна конфигурация помощнее. На VPS MAATRIX память и CPU наращиваются без переустановки сайта, что удобно при росте проекта.

Частые вопросы