Где MODX пишет ошибки
Первый файл — core/cache/logs/error.log. Сопоставляйте его время с PHP/web-server log: часть Fatal error может появиться только на уровне PHP-FPM или Nginx/Apache.
Сохранить и посмотреть MODX error.log
LOG=/path/to/site/core/cache/logs/error.log
cp "$LOG" "${LOG}.before-fix"
tail -n 150 "$LOG"
tail -f "$LOG"Сценарий 500 → куда смотреть
| Где 500 | Что проверить |
|---|---|
| Только фронтенд | plugin/system event, snippet, template, cache |
| Только Manager | connectors/processors, session, assets, ACL |
| После установки Extra | plugin, package, namespace, processor |
| После PHP update | Fatal/deprecated, extensions, Extra compatibility |
| После очистки cache | права core/cache, cache handler, filesystem |
Не начинайте с удаления core/cache
Очистка кэша иногда действительно помогает, но сначала сохраните error.log. Если удаление cache скрывает проблему только временно, нужно проверять права, cache handler и код, который создаёт некорректный cache.
Проверить cache и PHP
ls -ld /path/to/site/core/cache
find /path/to/site/core/cache -maxdepth 2 -type f | head -n 30
php -v
php --ini
php -m
php -l /path/to/file.phpЕсли ошибка появилась после конкретного Extra
Проверьте его plugin events, processors и логи. Не отключайте все плагины сразу: сначала найдите последнюю строку, где фигурирует файл/класс конкретного компонента. Если Manager доступен, отключение выполняйте штатно через интерфейс.
После исправления
Очистите кэш штатно, затем проверьте фронтенд, Manager, AJAX/connectors и критичные сниппеты. Убедитесь, что новая запись ошибки не появляется при повторном запросе.
Скачать набор диагностики
Связанные инструкции
Что передать при обращении по ошибке 500 в MODX
Для предметной диагностики подготовьте точный URL, время ошибки и действие, которое её вызывает. Проверьте журнал MODX core/cache/logs/error.log и серверные журналы PHP/веб-сервера. Отсутствие сообщения в MODX не исключает падения PHP до загрузки CMS. После обновления сверяйте версии MODX, PHP, установленных дополнений и состояние кэша.
Не очищайте вслепую журналы и не включайте вывод стека ошибок посетителям. Сначала сохраните копию логов и резервную копию сайта, затем тестируйте гипотезы по одной.