Установка и настройка Grav (Flat-File CMS)

Установка и настройка Grav (Flat-File CMS)

Grav не требует базы данных. Минимальные требования: PHP 7.3.6+ (рекомендуется 8.1+), расширения mbstring, curl, ctype, dom, gd, json, xml, zip. Apache или Nginx.

Установка

# Вариант 1: прямая загрузка
curl -L https://getgrav.org/download/core/grav-admin/latest -o grav-admin.zip
unzip grav-admin.zip -d /var/www/mysite
cd /var/www/mysite

# Вариант 2: через Composer
composer create-project getgrav/grav /var/www/mysite

# Установить права
find . -type f | xargs chmod 664
find . -type d | xargs chmod 775
find . -type d -name cache | xargs chmod 777
find . -type d -name logs | xargs chmod 777
find . -type d -name images | xargs chmod 777
find . -type d -name assets | xargs chmod 777

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

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

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # Защита служебных директорий
    location ~ ^/(\.git|cache|logs|backup|bin|system|vendor|\.env) {
        return 403;
    }

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

Конфигурация system.yaml

# user/config/system.yaml
home:
  alias: /home

pages:
  theme: my-theme
  markdown:
    extra: true          # включить Markdown Extra (таблицы, footnotes)
    auto_line_breaks: false

cache:
  enabled: true
  driver: auto
  lifetime: 604800

debugger:
  enabled: false

errors:
  display: 0
  log: true

languages:
  supported: [ru, en]
  include_default_lang: false
  translations: true

Конфигурация site.yaml

# user/config/site.yaml
title: Мой сайт
author:
  name: Компания
  email: [email protected]

metadata:
  description: Описание сайта

taxonomies: [category, tag]

summary:
  enabled: true
  size: 300

GPM — менеджер пакетов

# Обновить список пакетов
bin/gpm index

# Установить плагин
bin/gpm install form login admin sitemap feed

# Обновить всё
bin/gpm update

# Обновить ядро Grav
bin/gpm selfupgrade

# Список установленных пакетов
bin/gpm list

Создание пользователя администратора

# Через CLI (без веб-инсталлятора)
bin/plugin login newuser \
  --user=admin \
  --password=Admin123! \
  [email protected] \
  --name="Admin Name" \
  --admin=true

Кастомизация конфигурации окружений

# user/config/env/production/system.yaml — переопределения для prod
cache:
  enabled: true
  driver: redis
  redis:
    socket: '/var/run/redis/redis.sock'

debugger:
  enabled: false

# user/config/env/development/system.yaml
cache:
  enabled: false

debugger:
  enabled: true
  shutdown:
    close_connection: true

Переключение окружения через переменную GRAV_ENVIRONMENT=production или через setup.php:

// setup.php в корне
$environment = getenv('GRAV_ENVIRONMENT') ?: 'production';
define('GRAV_ENVIRONMENT', $environment);