
MODX – это гибкая CMS, поддерживающая как статические сайты, так и сложные веб-приложения. Для успешной установки требуется сервер с PHP версии 7.4 и выше, база данных MySQL 5.7 или MariaDB 10.3+, а также доступ к FTP или панели управления хостингом.
Первым шагом является загрузка последней стабильной версии MODX с официального сайта. Рекомендуется выбирать архив в формате ZIP, чтобы минимизировать ошибки при распаковке. После этого необходимо развернуть файлы в корневую директорию сайта или подкаталог, если сайт будет частью существующего проекта.
Перед началом установки важно создать базу данных и пользователя с полными правами на эту базу. Для MySQL это можно сделать через phpMyAdmin или консоль, задав кодировку UTF8mb4 для корректного отображения всех символов. Эти параметры будут использоваться в процессе установки MODX через веб-установщик.
Следующий этап – запуск веб-установщика по адресу сайта, где были размещены файлы MODX. Установщик проверит системные требования, наличие необходимых расширений PHP и прав на запись в директории core и assets. В случае ошибок рекомендуется корректировать настройки сервера перед продолжением.
После успешной проверки модуль установки предложит ввести данные базы данных, создать администратора и настроить основные параметры сайта. Рекомендуется сразу указать уникальный префикс таблиц и сложный пароль для учетной записи администратора. Завершение установки подтверждается доступом к панели управления MODX, откуда можно приступать к настройке шаблонов, ресурсов и дополнений.
Установка MODX на сайт: пошаговое руководство

Шаг 1. Подготовка сервера
Убедитесь, что ваш хостинг поддерживает PHP версии 7.4 и выше и MySQL 5.7 или MariaDB 10.3+. Проверьте права на запись в папках core, assets и config. Рекомендуется использовать Apache с включённым модулем mod_rewrite или Nginx с корректными правилами перенаправления.
Шаг 2. Загрузка MODX
Скачайте последнюю стабильную версию MODX с официального сайта modx.com/download. Распакуйте архив в корневую папку сайта. Убедитесь, что структура папок не нарушена: core, manager, connectors и assets должны находиться в корне.
Шаг 3. Создание базы данных
Создайте базу данных MySQL с кодировкой utf8mb4. Запишите имя базы данных, имя пользователя и пароль. Эти данные понадобятся при установке через веб-установщик MODX.
Шаг 4. Настройка веб-установщика
Откройте в браузере ваш_сайт/manager/. Следуйте инструкциям установщика. Введите данные базы данных, выберите язык интерфейса и укажите параметры администратора. Убедитесь, что проверка системных требований пройдена полностью.
Шаг 5. Завершение установки
После успешной установки удалите папку install для безопасности. Проверьте доступ к manager/ и убедитесь, что все основные страницы отображаются корректно. Настройте права на файлы: core/config/config.inc.php – 644, папки с кэшами – 755.
Шаг 6. Базовая оптимизация
Очистите кэш через менеджер MODX. Проверьте корректность URL-адресов и настройку ЧПУ. При использовании Nginx создайте файл modx.rewrite с правилами перенаправления, аналогичными .htaccess для Apache.
Проверка системных требований и подготовка хостинга

Перед установкой MODX необходимо убедиться, что сервер соответствует минимальным требованиям. MODX Revolution 3 требует PHP версии 7.4 или выше с поддержкой расширений PDO, cURL, JSON, mbstring, GD или ImageMagick. Для работы с базой данных поддерживаются MySQL 5.7+, MariaDB 10+ или Percona 5.7+. Рекомендуется наличие оперативной памяти не менее 256 МБ для стабильной работы панели управления.
Проверку можно выполнить с помощью phpinfo() или через панель управления хостингом. Обратите внимание на лимит памяти PHP (memory_limit), который должен быть ≥256M, и максимальное время выполнения скриптов (max_execution_time) не менее 60 секунд.
Для загрузки файлов MODX подготовьте FTP-доступ или SSH-доступ. Все файлы рекомендуется располагать в отдельной директории сайта с правами 755 для папок и 644 для файлов. Убедитесь, что сервер поддерживает чистые URL и наличие mod_rewrite (для Apache) или соответствующих правил для Nginx.
Создайте базу данных и пользователя с полными правами для MODX. Рекомендуется использовать UTF8mb4 кодировку и utf8mb4_general_ci сопоставление. Это обеспечит корректное хранение всех символов и эмодзи.
Перед установкой отключите лишние PHP-расширения, способные конфликтовать с MODX, такие как ionCube Loader или устаревшие версии Zend. Проверьте наличие доступа на запись в папки core, assets и config, так как MODX будет создавать конфигурационные файлы при установке.
Скачивание MODX и распаковка файлов на сервер
Перейдите на официальный сайт MODX по адресу https://modx.com/download/ и выберите стабильную версию «MODX Revolution». Рекомендуется скачивать последнюю стабильную сборку для обеспечения совместимости с современными версиями PHP и MySQL.
Скачанный архив будет в формате ZIP. На локальном компьютере убедитесь, что размер файла совпадает с указанным на сайте, чтобы исключить повреждение загрузки. После проверки распакуйте архив в отдельную папку, например, modx_temp.
Подключитесь к серверу через FTP/SFTP или используйте файловый менеджер хостинга. Создайте директорию на сервере для сайта, например, public_html/mysite. Переносите все файлы и папки из modx_temp в эту директорию. Структура должна сохраняться: в корне должны остаться файлы index.php, config.core.php и папка core.
После копирования файлов убедитесь, что права доступа установлены корректно: для папок core, assets и connectors рекомендуется значение 755, для файлов – 644. Неправильные права доступа могут блокировать установку или работу MODX.
Проверка успешного копирования: откройте в браузере адрес вашего сайта. Если все файлы на месте, появится экран установки MODX. Если возникают ошибки доступа к файлам, проверьте лог FTP или права на сервере и повторите копирование.
Создание базы данных и пользователя для MODX

Для корректной работы MODX необходима отдельная база данных MySQL или MariaDB. Начните с создания базы данных с уникальным именем, например modx_db, чтобы исключить конфликты с другими проектами.
Создайте пользователя базы данных с ограниченными правами, используя команду SQL:
CREATE USER 'modx_user'@'localhost' IDENTIFIED BY 'сложный_пароль';
Назначьте пользователю полный доступ к созданной базе:
GRANT ALL PRIVILEGES ON modx_db.* TO 'modx_user'@'localhost';
После назначения прав выполните команду FLUSH PRIVILEGES;, чтобы изменения вступили в силу.
Используйте сложный пароль длиной не менее 12 символов, включающий буквы верхнего и нижнего регистра, цифры и специальные символы. Это обеспечит защиту базы от несанкционированного доступа.
При настройке MODX укажите точные значения: имя базы, имя пользователя и пароль. Ошибки в этих параметрах приведут к невозможности соединения с базой данных.
Если сервер поддерживает phpMyAdmin, создание базы и пользователя можно выполнить через интерфейс: выберите «Базы данных», создайте новую, затем перейдите в «Привилегии» для добавления пользователя и назначения прав.
После успешного создания базы и пользователя убедитесь, что соединение проходит корректно с помощью утилиты командной строки mysql -u modx_user -p modx_db. Это предотвратит ошибки на этапе установки MODX.
Настройка конфигурационного файла и прав доступа
После копирования файлов MODX на сервер необходимо отредактировать основной конфигурационный файл core/config/config.inc.php. Этот файл содержит ключевые параметры подключения к базе данных и настройки безопасности.
Для корректной работы MODX убедитесь, что следующие параметры указаны точно:
| Параметр | Описание | Пример значения |
|---|---|---|
$database_type |
Тип базы данных | ‘mysql’ |
$database_server |
Адрес сервера базы данных | ‘localhost’ |
$database_user |
Имя пользователя базы данных | ‘modx_user’ |
$database_password |
Пароль пользователя базы данных | ‘securePass123’ |
$database_connection_charset |
Кодировка соединения с базой | ‘utf8’ |
$table_prefix |
Префикс таблиц MODX для одной базы | ‘modx_’ |
После сохранения конфигурации необходимо установить корректные права доступа к файлам и папкам. Основные требования:
| Путь | Рекомендованные права | Примечание |
|---|---|---|
core/config/ |
640 | Файл config.inc.php доступен только владельцу и веб-серверу |
assets/ |
755 для папок, 644 для файлов | Возможность записи для загрузки медиа и кеширования |
core/cache/ |
755 для папок, 644 для файлов | MODX должен иметь права на запись для кеширования |
core/packages/ |
755 для папок, 644 для файлов | Необходимы права записи для установки дополнительных пакетов |
Если сервер использует SELinux или другие системы контроля доступа, убедитесь, что веб-сервер имеет право читать и писать в указанные папки. Любые ошибки доступа могут привести к неработоспособности сайта или невозможности обновления кеша.
После настройки конфигурации и прав доступа рекомендуется протестировать соединение с базой данных через установщик MODX и проверить работу административной панели.
Запуск установщика и пошаговая настройка сайта
После загрузки файлов MODX на сервер откройте в браузере URL вашего сайта. Установщик автоматически запустится, если папка содержит файл index.php и все права доступа настроены правильно.
-
Выбор языка:
На первом экране выберите язык интерфейса. MODX поддерживает русский, английский и несколько других языков. После выбора нажмите «Далее».
-
Проверка системных требований:
Установщик проверяет версию PHP (рекомендуется 7.4 и выше), наличие расширений
pdo_mysql,gd,jsonи права на запись в папкиcore,assetsиmanager. Исправьте все ошибки до продолжения. -
Настройка базы данных:
- Введите тип базы данных – чаще всего MySQL.
- Укажите хост (обычно
localhost), имя базы, логин и пароль. - При необходимости создайте новую базу через phpMyAdmin или командную строку.
- Нажмите «Проверить соединение» для подтверждения доступности базы.
-
Настройка сайта:
- Укажите название сайта, которое будет отображаться в заголовках и метатегах.
- Установите URL сайта и префикс таблиц базы данных для предотвращения конфликтов.
- Выберите режим установки: «Чистая установка» или «С демонстрационными данными».
-
Создание учетной записи администратора:
- Придумайте уникальный логин и надежный пароль.
- Укажите рабочий email для восстановления доступа.
- Нажмите «Далее», чтобы завершить настройку учетной записи.
-
Завершение установки:
- Установщик создаст таблицы базы данных и настроит конфигурационный файл
config.inc.php. - После успешного завершения появится кнопка «Перейти в панель управления».
- Удалите папку
installс сервера для безопасности.
- Установщик создаст таблицы базы данных и настроит конфигурационный файл
После этих шагов MODX полностью готов к использованию, и можно переходить к созданию страниц, подключению шаблонов и настройке дополнительных компонентов.
Проверка работоспособности и базовая настройка панели управления
После установки MODX откройте панель управления по адресу <ваш_домен>/manager. Введите логин и пароль, указанные при установке. Если вход выполнен успешно, появится рабочее пространство с меню: «Ресурсы», «Элементы», «Система», «Безопасность».
Первым делом проверьте доступность всех системных настроек. Перейдите в «Система» → «Настройки» и убедитесь, что указаны правильные пути к core, assets и connector. Ошибки в этих параметрах приведут к некорректной работе сайта и невозможности загрузки медиа-файлов.
Далее протестируйте работу шаблонов и сниппетов. Создайте тестовую страницу через «Ресурсы» → «Создать ресурс». Присвойте шаблон и добавьте базовый контент. Сохраните и откройте страницу в браузере. Отображение контента без ошибок подтверждает корректную интеграцию шаблона.
Настройка пользователей и прав доступа критична для безопасности. В «Безопасность» → «Пользователи» создайте отдельную учетную запись администратора с ограниченными правами для тестирования. Проверьте доступ к разделам панели и возможность редактирования ресурсов.
Для оптимизации работы включите кэширование через «Система» → «Очистить кэш» и «Система» → «Настройки» → «Кэш». Убедитесь, что после изменения кэш обновляется корректно и страницы загружаются без задержек.
Последний шаг – проверка логов. В «Система» → «Логи» просмотрите записи за последние действия. Отсутствие ошибок при загрузке страниц и работе панели подтверждает стабильность установки и корректную настройку базовых функций.
Вопрос-ответ:
Какие требования к серверу для установки MODX?
Для работы MODX необходимо, чтобы сервер поддерживал PHP версии не ниже 7.3 и имел установленную базу данных MySQL или MariaDB. Также важно, чтобы была возможность загружать файлы через FTP или другой файловый менеджер и устанавливать права доступа на директории. Минимальный объем памяти PHP должен составлять 128 МБ, а рекомендуемый — 256 МБ, особенно если планируется использовать расширенные функции или большое количество плагинов.
Как подготовить базу данных перед установкой MODX?
Перед установкой нужно создать новую базу данных на сервере. Обычно это делается через панель управления хостингом, например, cPanel или phpMyAdmin. При создании базы данных необходимо указать имя базы, пользователя и пароль, а также присвоить пользователю все права на эту базу. После этого данные подключения (имя базы, логин, пароль, хост) нужно будет указать во время установки MODX.
Что делать, если при установке MODX появляется ошибка соединения с базой данных?
Ошибка соединения с базой данных чаще всего связана с неправильными данными подключения или отсутствием прав у пользователя. Следует проверить правильность имени базы данных, логина, пароля и адреса сервера базы данных. Также важно убедиться, что пользователь действительно имеет все права на базу, включая создание таблиц. Иногда проблема может быть связана с тем, что сервер базы данных находится на другом хосте, и нужно указать его точный адрес.
Можно ли установить MODX на локальный компьютер для тестирования?
Да, MODX можно установить на локальный сервер, например, с помощью XAMPP, WAMP или MAMP. Нужно установить пакет с веб-сервером Apache, PHP и MySQL, затем распаковать файлы MODX в папку сайта и запустить установку через браузер. Локальная установка удобна для тестирования шаблонов и плагинов перед переносом на рабочий сервер.
Какие шаги нужно выполнить после успешной установки MODX?
После завершения установки рекомендуется проверить работу сайта и панели управления. Нужно удалить или переименовать установочную директорию, чтобы предотвратить повторную установку. Затем можно настроить основные параметры сайта: создать разделы, страницы, добавить пользователей и установить необходимые плагины или шаблоны. Также стоит убедиться, что права доступа на файлы и папки выставлены корректно для защиты сайта от несанкционированного доступа.
