Как установить MODX Revolution: пошаговая инструкция

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

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

Ниже описан типовой сценарий для MODX Revolution 3.x и веб-хостинга с Apache или Nginx. Точные требования зависят от минорной версии и выбранного пакета, поэтому перед загрузкой откройте документацию и проверьте требования именно к вашему архиву.

• Домен или временный адрес хостинга, который уже направлен на сервер.
• Доступ к файлам сайта по FTP, SFTP или через файловый менеджер панели хостинга.
• Доступ к созданию базы данных и отдельный пользователь базы. Подойдут MySQL или совместимая конфигурация, которую поддерживает выбранная версия MODX.
• Поддерживаемая версия PHP и расширения, перечисленные в требованиях MODX 3.x.
• Имя базы, имя пользователя, пароль, адрес сервера базы и порт, если хостинг использует нестандартный.
• Пароль администратора MODX. Не используйте пароль от почты или панели хостинга.

Сноска. Веб-инсталлятор — это мастер настройки, который запускается в браузере и записывает параметры подключения к базе в конфигурацию MODX. Он не заменяет создание базы: базу и пользователя нужно подготовить в панели хостинга заранее.

Не начинайте с загрузки архива. Сначала убедитесь, что PHP, база и права на запись подходят конкретному релизу MODX: большая часть неудачных установок ломается именно на этом этапе.

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

1. Создайте базу данных

Откройте панель хостинга и создайте базу, пользователя и пароль. Для пользователя выдайте права на созданную базу. Запишите значения без лишних пробелов: инсталлятор запросит их по отдельности.

Если панель предлагает выбрать кодировку и сравнение, используйте рекомендуемые хостингом значения из документации MODX и самого хостинга. Не меняйте настройки базы наугад ради «оптимизации».

Проверка: в панели видны база и пользователь, а пользователь имеет права на чтение, запись, изменение структуры и создание таблиц.

2. Скачайте и распакуйте пакет MODX

Загрузите пакет MODX Revolution с официальной страницы загрузки. Выбирайте архив для обычной веб-установки, а не исходный код проекта, если на странице доступны несколько вариантов.

Распакуйте содержимое в каталог домена. Важно, чтобы файлы MODX лежали в корне сайта, если вы планируете открывать его по адресу https://example.com/. Ошибка с лишней вложенной папкой выглядит так: сайт открывается только по адресу https://example.com/modx/.

Перед загрузкой проверьте свободное место и лимит размера файлов. Передавать архив через FTP недостаточно — на сервере должны появиться распакованные каталоги и файлы MODX.

Проверка: в корне домена видны файлы MODX, включая каталог setup, а адрес сайта пока показывает установщик или стандартную страницу хостинга.

3. Откройте установщик

Перейдите в браузере по адресу https://ваш-домен.example/setup/. Если сайт работает по HTTP, используйте тот протокол, который настроен на домене; после появления рабочего HTTPS лучше включить перенаправление на него.

На первом экране выберите язык и запустите новую установку. Если MODX показывает предупреждения о версии PHP или расширениях, не пропускайте их без проверки: часть функций может не работать уже после входа в менеджер.

Проверка: открылась страница установщика MODX с выбором типа установки, а не ошибка 404, пустая страница или список файлов каталога.

4. Пройдите проверку окружения

Инсталлятор проверит PHP, расширения и права на каталоги. Красные ошибки нужно исправить до продолжения. Обычно причина находится в одной из трёх зон: версия PHP, отсутствующее расширение или каталог, в который веб-сервер не может записать файл.

Если хостинг позволяет менять PHP для отдельного домена, выберите версию, совместимую с вашим релизом MODX. Не ориентируйтесь только на то, что другая CMS на этом же сервере запускается: у MODX может быть другой набор требований.

Проверка: обязательные проверки отмечены как пройденные, а установщик разрешает перейти к подключению базы.

5. Подключите базу данных

Заполните поля данными, которые вы сохранили на первом шаге:

• сервер базы данных — значение, указанное хостингом, часто это локальный адрес;
• имя базы данных;
• имя пользователя;
• пароль;
• порт — только если хостинг не использует значение по умолчанию;
• префикс таблиц — оставьте предложенный вариант, если на этой базе будет только один сайт.

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

Проверка: MODX сообщает, что подключение к базе успешно, и показывает параметры установки без ошибки авторизации.

6. Создайте администратора

Укажите имя пользователя и сложный пароль для входа в менеджер MODX. Добавьте рабочий адрес электронной почты: он понадобится для уведомлений и восстановления доступа, если такая возможность настроена на сервере.

Не называйте администратора admin, если этого можно избежать, и не вставляйте пароль в заметки, доступные всему проекту. Имя пользователя и пароль от MODX не должны совпадать с данными базы.

Проверка: установщик принимает данные формы и позволяет перейти к финальному шагу, не показывая ошибку валидации.

7. Установите MODX и войдите в менеджер

Запустите установку. MODX создаст таблицы, запишет конфигурацию и установит стартовые данные. Продолжительность зависит от хостинга и обычно определяется скоростью записи файлов и базы.

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

Проверка: открывается панель MODX, видны дерево ресурсов и системные настройки, а повторный переход к /setup/ не оставляет установщик доступным для посторонних.

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

Сразу после входа не устанавливайте десятки дополнений. Сначала проверьте базовую конфигурацию и сделайте резервную копию чистой установки.

1. Откройте главную страницу в режиме гостя. Должен отображаться стартовый ресурс или ваш опубликованный документ.
2. Создайте тестовую страницу, опубликуйте её и откройте по ссылке из менеджера. Так вы проверите запись в базу и публикацию ресурса.
3. Включите человекопонятные URL только после проверки серверных правил. Для Apache проверьте наличие и работу файла .htaccess; для Nginx используйте конфигурацию из официальной документации MODX и настройки своего хостинга.
4. Выйдите из менеджера и снова войдите. Это проверяет сессии, cookie и корректность HTTPS.
5. Создайте резервную копию файлов и базы. Без обеих частей восстановление сайта может оказаться неполным.

Проверка: тестовая страница открывается без ошибки 404, менеджер принимает повторный вход, а резервная копия действительно скачивается или отображается в панели хостинга.

Если установка не получилась

Белая страница или ошибка 500

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

Ошибка подключения к базе данных

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

Установщик не может записать файл

Проверьте владельца файлов и права на запись для каталогов, которые указал MODX. На VPS причиной может быть пользователь веб-сервера, на общем хостинге — неверно загруженные права или распаковка от другого системного пользователя.

После установки 404 на страницах

Проверьте, включён ли нужный режим URL и настроены ли правила веб-сервера. Для Apache убедитесь, что хостинг разрешает использование .htaccess. Для Nginx не копируйте правила Apache без адаптации: это разные форматы конфигурации.

Менеджер открывается, но часть интерфейса не работает

Проверьте консоль браузера, журнал PHP и совместимость установленных дополнений с MODX Revolution 3.x. Сначала временно отключите недавно добавленное дополнение, затем проверяйте остальные изменения по одному.

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

После чистой установки настройте HTTPS, резервное копирование и отдельную тестовую копию сайта. Затем создайте структуру ресурсов и только после этого добавляйте дополнения, шаблоны и интеграции. В продакшене регулярно смотрите журнал PHP, ошибки 404 и время ответа менеджера: эти три сигнала быстрее всего показывают проблемы с сервером, URL и перегруженными дополнениями.