Установка MODX Revolution: что проверить до начала

Установка MODX Revolution 3.x обычно занимает 20–40 минут, если заранее подготовлены домен, база данных, доступ к файлам и подходящая версия PHP. Если пропустить проверку окружения, мастер установки может не запуститься, а готовый сайт — не сохранить настройки, очистить кеш или загрузить изображения.

Что подготовить до начала

Эта инструкция относится к ветке MODX Revolution 3.x. У Revolution 2.x отличаются требования, экран установщика и часть системных настроек, поэтому не смешивайте инструкции для разных веток.

• Дистрибутив MODX Revolution 3.x. Скачивайте его с официального сайта или из официального источника проекта. Не берите архивы с форумов и файлообменников.
• Хостинг или сервер. Нужен веб-сервер с PHP и базой данных. Точный список поддерживаемых версий PHP и расширений сверяйте с требованиями выбранного релиза: он может меняться между версиями MODX.
• База данных. Подготовьте имя базы, имя пользователя, пароль, адрес сервера базы и порт, если он нестандартный. Пользователю нужны права на создание и изменение таблиц.
• Доступ к файлам сайта. Подойдут файловый менеджер панели хостинга, SFTP или SSH. FTP лучше не использовать для передачи паролей и административных файлов.
• Домен или тестовый адрес. До установки проверьте, что домен уже указывает на нужный сервер. Для рабочей установки нужен HTTPS, но саму проверку домена можно выполнить и до выпуска сертификата.
• Резервная копия. На пустом аккаунте она не обязательна. Если MODX ставится поверх старого сайта, сначала сохраните файлы и дамп базы: установка поверх существующей системы может привести к потере данных.

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

Проверьте сервер до загрузки MODX

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

1. Откройте настройки домена. Найдите раздел PHP, PHP-FPM или «Настройки сайта». Запишите текущую версию и убедитесь, что она входит в диапазон, указанный в документации выбранного релиза MODX 3.x. Проверка: в настройках домена видна версия PHP, а не только общая версия на аккаунте.
2. Сверьте расширения PHP. Установщик сам покажет часть отсутствующих компонентов, но лучше проверить их заранее по официальным требованиям. Особенно важны расширения для работы с базой, XML, изображениями и архивами. Не включайте расширения наугад: ориентируйтесь на требования конкретной версии. Проверка: список расширений хостинга сопоставлен с официальной документацией.
3. Проверьте лимиты. Посмотрите значения memory_limit, upload_max_filesize, post_max_size и max_execution_time. Слишком маленькие лимиты могут сорвать загрузку большого пакета или импорт данных, даже если сама установка проходит. Проверка: вы знаете, где эти параметры меняются, или получили от хостинга подтверждение, что их можно увеличить.
4. Проверьте HTTPS и URL. Откройте домен в браузере, проверьте редирект на HTTPS и отсутствие лишнего подкаталога в адресе. Если MODX будет жить в example.ru/cms, это нужно учитывать при загрузке файлов и открытии установщика. Проверка: домен открывается именно по тому адресу, который станет адресом сайта.

Сноска. PHP-FPM — режим работы PHP, при котором веб-сервер передаёт выполнение скриптов отдельному пулу процессов. Его параметры могут отличаться от настроек PHP в командной строке.

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

Создайте базу данных и доступ

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

1. Создайте базу. В панели хостинга выберите MySQL или MariaDB, задайте имя базы и кодировку, если панель предлагает этот выбор. Для нового проекта обычно выбирают современную Unicode-кодировку, которую рекомендует документация выбранного релиза. Проверка: база появилась в списке и имеет понятное имя.
2. Создайте отдельного пользователя. Не используйте учётную запись администратора всей СУБД, если хостинг позволяет создать пользователя с правами только на эту базу. Проверка: пользователь привязан к нужной базе и может создавать, изменять и удалять её таблицы.
3. Сохраните параметры отдельно. Запишите имя базы, пользователя, пароль, адрес сервера и порт в менеджер паролей. Не вставляйте эти данные в публичные тикеты, скриншоты и репозитории. Проверка: все пять параметров доступны до открытия установщика.

На shared-хостинге адрес базы часто отличается от localhost. Используйте значение из панели, а не догадку. Если база находится на отдельном сервере, проверьте, разрешены ли подключения с веб-сервера.

Загрузите файлы и откройте установщик

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

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

«Не удалось подключиться к базе данных»

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

«Требуется расширение PHP» или проверка окружения не пройдена

Сверьте сообщение с требованиями именно вашего релиза MODX 3.x. Включите недостающее расширение в настройках PHP домена или попросите это сделать поддержку хостинга. Не меняйте версию PHP вслепую: сначала проверьте совместимость всех компонентов сайта.

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

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

«Permission denied» или MODX не может записать файл

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

После установки не сохраняются настройки или не очищается кеш

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

Что проверить сразу после входа

• Откройте главную страницу и страницу администратора по HTTPS.
• Создайте тестовый ресурс и проверьте его публикацию.
• Загрузите небольшое изображение, чтобы проверить права на каталог медиафайлов.
• Очистите кеш и убедитесь, что операция завершается без ошибки.
• Настройте резервное копирование файлов и базы до добавления реального контента.
• Проверьте часовой пояс, адрес сайта и почтовые настройки, не отправляя тестовые письма случайным пользователям.

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