Встановлення та налаштування CMS MODX Revolution

Встановлення та налаштування CMS MODX Revolution

MODX Revolution 3.x встановлюється через веб-інсталятор або CLI. Production-встановлення вимагає налаштування Nginx, кешування, конфігурації .htaccess/nginx правил для 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 від прямого веб-доступу.

Ключові системні налаштування

System → Settings → System:

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

System → Package Management → Пошук пакетів:

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

Для форм:
- FormIt

Для пошуку:
- SimpleSearch або mSearch2

Package Manager через консоль

// Встановлення через 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: System → Contexts → web → URL
3. Створити кореневий ресурс (Головна сторінка) з шаблоном Default
4. Налаштувати Error Page (404): System → Settings → error_page → ID ресурсу

Терміни

Встановлення MODX на VPS з перемещенням core вище web-root, налаштуванням Nginx та базовими Extras — 3–5 годин.