FAQ и устранение неполадок

Частые вопросы и быстрые решения для MODX 3. Для глубокой диагностики см. тематические страницы ниже. Если помощи всё ещё не хватает, спросите в сообществе MODX или Slack.

Связанные материалы по устранению неполадок¶

• Устранение неполадок при установке
• Устранение неполадок при обновлении
• Устранение неполадок при управлении пакетами
• Устранение неполадок безопасности
• FAQ и устранение неполадок при разработке CMP

1. MODX 101¶

1.1. Что такое MODX / MODX Revolution / MODX Evolution?¶

На форумах и в поиске часто смешивают линейки продукта. Краткая карта:

• MODX / MODX Revolution 3.x — активно развиваемая CMS, описанная в этой документации. Концепции см. в Обзор MODX.
• MODX Revolution 2.x — предыдущая мажорная линейка Revolution. Многие боевые сайты всё ещё на ней. Переход на 3.x поддерживается при планировании; начните с Обновление с 2.x до 3.0.
• MODX Evolution — отдельная старая ветка 1.x. Эти документы для 3.x её не покрывают. Сайты на Evolution требуют проекта миграции, официального обновления в один клик нет. Исторические заметки: Обновление с Evolution.

1.2. Какая версия PHP и сервера нужна?¶

См. Требования к серверу. Текущий MODX 3.x (3.2 и новее) требует PHP 8.1 или выше. MODX 3.0 изначально допускал PHP 7.2+, но в 3.2 порог подняли.

1.3. Какие теги можно использовать? Что такое [[*pagetitle]], [[Wayfinder]] и т. д.?¶

См. Синтаксис тегов. Поля ресурсов для тегов перечислены на странице Ресурсы.

2. Менеджер¶

2.1. Куда делась боковая панель / дерево ресурсов?¶

Скорее всего вы её свернули. На левом краю экрана есть маленькая стрелка (см. изображение). Нажмите её, чтобы вернуть дерево. Если после разворота дерево пустое, обновите страницу.

2.2. Как изменить, какие поля ресурса видны при редактировании?¶

Используйте Настройку форм, чтобы скрыть, переименовать или переставить поля на экранах создания и редактирования ресурса (и ограничить правила группами пользователей или шаблонами).

2.3. Что означают modDocument / modWeblink / modSymLink / modStaticResource?¶

Это имена классов встроенных типов ресурсов (в 3.x они в пространстве имён MODX\Revolution\, короткие имена всё ещё часто используют). Все отображаются в дереве ресурсов:

• Документы (класс modDocument): обычные страницы с контентом. Слово «ресурс» часто имеют в виду именно документ.
• Веб-ссылки: редирект на другой ресурс или внешний URL
• Симлинки: повторное использование контента другого документа по другому URL
• Статические ресурсы: контент берётся из файла на диске

2.4. В чём разница между ресурсом и документом?¶

Технически ресурс (modResource): абстрактная база, документ (modDocument): обычная HTML-страница. В разговоре «ресурс» часто значит «та страница в дереве», хотя это может быть документ, веб-ссылка, симлинк или статический ресурс.

2.5. Меня заблокировали в Менеджере / я забыл пароль¶

См. Ручной сброс пароля пользователя.

2.6. В Менеджере ошибка 500 Internal Server Error¶

Попробуйте по порядку:

1. Очистите или переименуйте core/cache/ (частая причина: повреждённый кеш).
2. Откройте Менеджер в приватном/инкognito-окне (исключит битые cookie и сессии).
3. Убедитесь, что PHP соответствует требованиям к серверу для вашей версии MODX.
4. Проверьте core/cache/logs/error.log: там будет реальная PHP-ошибка.

Больше случаев при установке: в Устранение неполадок при установке.

2.7. Менеджер пустой / показывает «undefined» / сломанная вёрстка¶

Часто виноваты не загрузившиеся JS/CSS или битый кеш. Очистите core/cache/, сделайте жёсткое обновление браузера и см. чеклист сообщества: Blank manager with undefined message. Также Устранение неполадок при установке, включая отключение compress_js / compress_css, если URL ресурсов не открываются.

3. Фронтенд и проблемы с кешем¶

3.1. Пустые страницы фронтенда, которые оживают после очистки кеша¶

На некоторых хостах (особенно отдельные облачные и shared-схемы) блокировка файлов при записи кеша даёт пустые страницы или 500 после сохранения, пока не удалите core/cache/.

В core/config/config.inc.php отключите flock: добавьте use_flock в $config_options и установите false:

$config_options = array(
 'use_flock' => false,
);

(Объедините с уже существующими записями $config_options, не заменяйте массив целиком.)

3.2. Сниппет или плагин ничего не делает¶

Проверьте, что он установлен и включён (Extras → Installer / дерево элементов), что имя в теге совпадает, и что вы очистили кеш после установки или правки. Закешированные страницы будут отдавать старый вывод, пока кеш не сбросите.

4. Обновление¶

4.1. Как обновиться в рамках 3.x или с 2.x на 3.x?¶

Следуйте Обновление MODX. Для любого перехода с 2.x на 3.x сначала прочитайте Обновление с 2.x до 3.0: меняются пространства имён классов, процессоры, путь к ядру и требования к PHP. Помните, что 3.2+ требует PHP 8.1+.