Установка и настройка 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-режим