Установка и настройка CMS MODX Revolution

Установка и настройка CMS MODX Revolution

MODX Revolution 3.x устанавливается через веб-инсталлятор или CLI. Production-установка требует настройки Nginx, caching, конфигурации .htaccess/nginx rules для SEF URL.

Установка через Composer

# MODX 3.x поддерживает Composer
composer create-project modx/modx my-site
cd my-site

# Или традиционная установка
wget https://modx.com/download/current/ -O modx.zip
unzip modx.zip

Nginx конфигурация

server {
    listen 443 ssl http2;
    server_name yourdomain.com;
    root /var/www/yourdomain.com;
    index index.php;

    # SEF URL для MODX
    location / {
        try_files $uri $uri/ @modx-rewrite;
    }

    location @modx-rewrite {
        rewrite ^/(.*)$ /index.php?q=$1 last;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Запретить доступ к системным файлам
    location ~ /\.(ht|git) { deny all; }
    location ~ /(core|config\.core\.php) { deny all; }
    location ~* /connectors/.*\.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Веб-инсталлятор

Открыть https://yourdomain.com/setup/. Шаги:

1. Проверка прав доступа (должны быть доступны для записи: core/cache/, core/export/, assets/)
2. Параметры БД
3. Создание администратора
4. Настройка контекста (http/https, базовый URL)
5. Удалить папку setup/ после установки

Безопасность: перемещение core

По умолчанию core/ находится в web-root. Рекомендуется переместить выше:

mv /var/www/yourdomain.com/core /var/core-yourdomain

# config.core.php (в web-root)
<?php
define('MODX_CORE_PATH', '/var/core-yourdomain/');
define('MODX_CONFIG_KEY', 'config');

Это скрывает основные файлы CMS от прямого веб-доступа.

Ключевые системные настройки

Система → Настройки → Система:

friendly_urls: Да
friendly_alias_urls: Да
use_alias_path: Да        # иерархические URL /about/team/
cache_resource: Да
cache_context_settings: Да
session_cookie_secure: Да  # только HTTPS
session_cookie_httponly: Да

Установка Extras через Package Manager

Система → Package Management → Поиск пакетов:

Обязательные для большинства проектов:
- pdoTools (основа для pdoResources, pdoMenu, pdoPage)
- FastTab (организация TV в вкладках)
- Ace (редактор кода с подсветкой)
- Seosuite или seo (SEO мета-теги)

Для форм:
- FormIt

Для поиска:
- SimpleSearch или mSearch2

Менеджер пакетов через консоль

// Установка через API
$modx->runSnippet('pdoTools');  // проверка

// Или через transport package
$pkg = $modx->newObject('transport.modTransportPackage');
$pkg->fromXML('path/to/package.transport.zip');
$pkg->install();

Базовая настройка после установки

1. Создать шаблон Default (пустой HTML, чтобы начать разработку)
2. Настроить контекст web: Система → Контексты → web → URL
3. Создать корневой ресурс (Главная страница) с шаблоном Default
4. Настроить Error Page (404): Система → Настройки → error_page → ID ресурса 404

Сроки

Установка MODX на VPS с переносом core выше web-root, настройкой Nginx и базовыми Extras — 3–5 часов.