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

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

Concrete CMS вимагає PHP 7.4–8.2, MySQL 5.7+/MariaDB 10.2+ або PostgreSQL, Apache/Nginx. Офіційно підтримується встановлення через Composer — це переважний спосіб для проектів.

Встановлення через Composer

composer create-project -n concrete5/composer mysite
cd mysite

# Веб-інсталятор: відкрити http://yourdomain.com/index.php/install
# Або CLI-встановлення:
./vendor/bin/concrete5 c5:install \
  --db-server=localhost \
  --db-username=myuser \
  --db-password=secret \
  --db-database=mysite_db \
  --site="My Site" \
  [email protected] \
  --admin-password=StrongPass123 \
  --starting-point=elemental_blank

Стартові точки: elemental_blank (чистий), elemental_full (з демо-контентом).

Структура директорій

mysite/
  application/          # кастомізації (в git)
    config/
    files/
    single_pages/
    views/
  concrete/             # ядро CMS (не трогати, оновлюється через composer)
  packages/             # встановлені пакети (в git)
  public/               # веб-рут (document root)
    application/
    packages/
    index.php
  vendor/               # composer залежності (не в git)

Document root сервера повинен указувати на директорію public/.

Nginx-конфігурація

server {
    listen 80;
    server_name mysite.com;
    root /var/www/mysite/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

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

    # Закрити application/
    location ~* ^/application/ {
        deny all;
    }
}

Конфігурація окруження

// application/config/app.php
return [
    'debug'     => false,
    'url'       => 'https://mysite.com',
    'charset'   => 'UTF-8',
    'timezone'  => 'Europe/Minsk',
    'locale'    => 'ru_RU',
];

// application/config/database.php
return [
    'default-connection' => 'concrete',
    'connections'        => [
        'concrete' => [
            'driver'   => 'c5_pdo_mysql',
            'server'   => 'localhost',
            'database' => 'mysite_db',
            'username' => 'myuser',
            'password' => 'secret',
            'charset'  => 'utf8mb4',
        ],
    ],
];

Переменные окружения (.env)

CONCRETE5_DB_SERVER=localhost
CONCRETE5_DB_DATABASE=mysite_db
CONCRETE5_DB_USERNAME=myuser
CONCRETE5_DB_PASSWORD=secret
CONCRETE5_URL=https://mysite.com

Обновление ядра

composer update concrete5/core
./vendor/bin/concrete5 c5:update
./vendor/bin/concrete5 c5:cache:clear

CLI-команди для адміністрування

# Очистити кеш
./vendor/bin/concrete5 c5:cache:clear

# Встановити пакет
./vendor/bin/concrete5 c5:package:install my-package

# Створити користувача
./vendor/bin/concrete5 c5:user:add admin2 [email protected] Password123

# Перестроити поисковий індекс
./vendor/bin/concrete5 c5:index:sites

Dashboard: першочергова настройка

Після встановлення через Dashboard → System & Settings:

• Cache & Speed — увімкнути Full Page Caching в продакшені
• SEO & Statistics — налаштувати canonical URL, robots.txt
• Files — максимальний розмір загрузки, дозволені типи
• Email — SMTP-налаштування (обов'язково до запуску форм)
• API — увімкнути REST API якщо потрібен headless-режим