Установка MODX Revolution: частые ошибки новичков

MODX Revolution 3.x обычно устанавливается за 20–40 минут, но новичков чаще подводит не сам движок, а окружение: неподходящая версия PHP, неверные права на файлы, пустая база или запуск установщика не из той папки. В конце у вас будет рабочая админка MODX и понятный план проверки, если вместо неё открывается ошибка 500 или белая страница.

Что подготовить до установки

Инструкция рассчитана на MODX Revolution 3.x. Конкретные требования зависят от минорной версии и способа установки, поэтому перед загрузкой архива сверяйте системные требования именно выбранного релиза в официальной документации.

• домен или временный адрес сайта;
• доступ к панели хостинга и файлам по FTP, SFTP или через файловый менеджер;
• созданная база данных MySQL или MariaDB, её имя, пользователь, пароль и адрес сервера;
• архив MODX Revolution из официального источника;
• версия PHP и возможность выбрать её в панели хостинга;
• резервная копия каталога сайта, если на домене уже лежат файлы.

Термин: document root — корневая папка сайта, из которой веб-сервер отдаёт файлы домена. На хостинге она может называться public_html, www, htdocs или иначе. Если распаковать MODX уровнем выше, домен покажет список файлов или старую страницу.

Большинство проблем при установке MODX возникает до запуска установщика. Сначала проверьте PHP, базу и корневую папку, а уже потом ищите ошибку в самом движке.

Пошаговая установка MODX Revolution

1. Проверьте версию PHP. Откройте настройки домена в панели хостинга и выберите версию, которая указана в требованиях вашего релиза MODX Revolution 3.x. Не ориентируйтесь на совет из старой статьи: совместимость PHP меняется между версиями MODX и расширениями. Проверка: в панели отображается выбранная версия PHP, а среди расширений включены те, которые перечислены в документации релиза.
2. Создайте отдельную базу данных. В панели хостинга создайте базу и пользователя, назначьте пользователю полный доступ к этой базе. Сохраните точные значения имени базы, имени пользователя, пароля и хоста базы: на одном хостинге это localhost, на другом — отдельное имя сервера. Проверка: база отображается в панели, пользователь привязан к ней, а вы можете скопировать реквизиты без ручного набора.
3. Загрузите архив в document root. Скачайте архив MODX только из официального источника и загрузите его в корневую папку домена. Если используете FTP, передача большого числа мелких файлов может занять время; SFTP или распаковка архива на сервере обычно надёжнее. Проверка: в корневой папке видны файлы MODX, а не только один вложенный каталог с названием архива.
4. Распакуйте файлы и проверьте структуру. После распаковки откройте домен в браузере. MODX должен предложить перейти к установке или открыть путь /setup/. Если браузер показывает содержимое папки, вы открыли не тот каталог или на сервере не работает индексный файл. Проверка: по адресу домена и по адресу https://ваш-домен/setup/ появляется экран установки, а не список файлов.
5. Запустите мастер установки. Выберите язык и подтвердите переход к новой установке. Мастер проверит окружение и покажет предупреждения по PHP, расширениям и правам. Не пропускайте красные ошибки: предупреждение можно изучить отдельно, а критическую ошибку сначала исправьте. Проверка: мастер переходит к настройкам базы, а в списке окружения нет неустранённых критических пунктов.
6. Заполните подключение к базе. Введите имя базы, пользователя, пароль и адрес сервера ровно так, как их создала панель хостинга. Не добавляйте к имени базы префикс повторно: некоторые панели уже включают его в отображаемое имя. Кодировку и префикс таблиц оставьте по умолчанию, если у вас нет причины изменить их. Проверка: MODX принимает реквизиты и переходит к созданию таблиц.
7. Создайте учётную запись администратора. Укажите логин, сложный пароль и рабочий адрес электронной почты. Не используйте пароль от панели хостинга или почты. Эти данные нужны для входа в менеджер MODX, а не для FTP. Проверка: установщик принимает форму администратора и показывает сводку параметров.
8. Завершите установку и удалите каталог setup. После создания таблиц войдите в админку по адресу, который предлагает мастер. Каталог setup нужно удалить или сделать недоступным согласно инструкции вашей версии MODX: оставленный установщик создаёт риск повторного запуска. Проверка: менеджер открывается, вы видите панель управления, а повторный переход к /setup/ больше не запускает установку.
9. Сделайте базовую проверку сайта. Откройте главную страницу, войдите и выйдите из админки, создайте тестовый ресурс и проверьте ЧПУ только после того, как базовая установка работает. Не ставьте сразу десятки дополнений: иначе при ошибке будет непонятно, виноват ли MODX, PHP или сторонний пакет. Проверка: главная страница и менеджер открываются, тестовый ресурс сохраняется, в журнале ошибок нет новых критических записей.

Частые ошибки и быстрые проверки

Ошибка 500 сразу после открытия сайта

Чаще всего причина — несовместимая версия PHP, отсутствующее расширение или ошибка в настройках веб-сервера. Посмотрите error log домена в панели хостинга: браузер обычно показывает только общий код 500, а настоящая причина находится в журнале. Сверьте PHP и обязательные расширения с требованиями конкретной версии MODX, затем повторите запрос.

«Could not connect to database» или «Access denied for user»

Проверьте четыре значения: имя базы, имя пользователя, пароль и адрес сервера базы. На виртуальном хостинге имя базы и пользователя часто имеют префикс аккаунта. Если хост базы указан как localhost, это не означает, что такой адрес подходит везде: используйте значение из панели провайдера.

Белая страница

Белый экран не означает, что сайт пустой. Сначала включите просмотр ошибок только на тестовом сайте или откройте журнал PHP и веб-сервера. Частые причины — фатальная ошибка PHP, неподходящее расширение или несовместимое дополнение. Не включайте показ подробных ошибок на публичном домене: в сообщениях могут оказаться пути к файлам и параметры окружения.

403 Forbidden или ошибка доступа к файлам

Проверьте права на каталоги и файлы, владельца файлов и правила веб-сервера. Не выставляйте максимальные права на весь сайт «для проверки»: это убирает симптом ценой безопасности. Если файлы загружались под другим системным пользователем, попросите хостинг исправить владельца или выполните загрузку способом, рекомендованным провайдером.

Вместо установщика открывается старая страница

Домен может указывать на другую папку, а браузер — показывать закешированный ответ. Сначала проверьте document root в панели, затем наличие файлов MODX именно в нём. Очистите кеш браузера и CDN, если он подключён, но не начинайте с очистки кеша: она не исправит неверный путь к файлам.

Что проверить после установки

• В настройках домена включён HTTPS, а сайт открывается по одному основному адресу.
• Резервное копирование включает и файлы, и базу данных. Бэкап только файлов не восстановит контент.
• Админка недоступна посторонним: используйте HTTPS, отдельный сложный пароль и ограничения панели хостинга, если они предусмотрены.
• В журнале ошибок нет повторяющихся сообщений после открытия главной страницы и менеджера.
• Перед установкой дополнений записаны версии MODX, PHP и самого дополнения.

Что делать дальше

Сначала настройте автоматическую копию базы и файлов, затем создайте тестовую страницу и проверьте публикацию по ЧПУ. После этого изучите официальную документацию для своей ветки MODX Revolution 3.x и только потом подключайте дополнения. В продакшене следите за журналами PHP и веб-сервера, свободным местом и временем ответа админки: эти показатели обычно первыми показывают, что проблема уже не в установке, а в окружении или расширениях.