Поиск по сайту:

Как установить Grav CMS с Nginx на Debian 9

На этой странице

  1. Требования
  2. Предпосылки
  3. Шаг 1. Установите PHP и расширения PHP
  4. Шаг 2. Установите клиент Acme.sh и получите сертификат Lets Encrypt (необязательно)
  5. Шаг 3. Установите и настройте NGINX
  6. Шаг 4. Установите Grav CMS
  7. Шаг 5. Завершите настройку Grav.
  8. Ссылки

Grav — это быстрая, простая и гибкая файловая веб-платформа. Он следует тем же принципам, что и другие платформы CMS с плоскими файлами, но имеет другую философию дизайна, чем большинство. Grav поставляется с мощной системой управления пакетами, позволяющей легко устанавливать и обновлять плагины и темы, а также просто обновлять сам Grav.

Базовая архитектура Grav предназначена для использования хорошо зарекомендовавших себя и лучших в своем классе технологий, чтобы обеспечить простоту использования и расширения Grav. Некоторые из этих ключевых технологий включают в себя:

  • Twig Templates: для мощного управления пользовательским интерфейсом.
  • Markdown: для простого создания контента.
  • YAML: для простой настройки.
  • Parsedown: для быстрой поддержки Markdown и Markdown Extra.
  • Кэш Doctrine: уровень производительности
  • Контейнер внедрения зависимостей Pimple: расширяемость и удобство сопровождения.
  • Symfony Event Dispatcher: для обработки событий плагина.
  • Symfony Console: для интерфейса CLI
  • Библиотека изображений Gregwar: для динамического управления изображениями.

В этом руководстве мы шаг за шагом проведем вас через процесс установки Grav CMS в операционной системе Debian 9 с использованием Nginx в качестве веб-сервера, а также acme.sh и Lets Encrypt для HTTPS.

Требования

  • Веб-сервер (Apache, Nginx, LiteSpeed, Lightly или IIS). В этом руководстве мы будем использовать NGINX.
  • PHP 7.1.3 или выше со следующими расширениями PHP: curl, ctype, dom, gd, json, mbstring, openssl, session, simplexml, xml, zip, apcu (необязательно), opcache (необязательно).

Предпосылки

  • Операционная система под управлением Debian 9.
  • Пользователь без полномочий root с привилегиями sudo.

Начальные шаги

Проверьте свою версию Debian:

lsb_release -ds
# Debian GNU/Linux 9.9 (stretch)

Настройте часовой пояс:

sudo dpkg-reconfigure tzdata

Обновите пакеты операционной системы (программное обеспечение). Это важный первый шаг, поскольку он гарантирует наличие последних обновлений и исправлений безопасности для пакетов программного обеспечения вашей операционной системы по умолчанию:

sudo apt update && sudo apt upgrade -y

Установите несколько основных пакетов, необходимых для базового администрирования операционной системы Debian:

sudo apt install -y curl wget vim git unzip socat apt-transport-https

Шаг 1 — Установите PHP и расширения PHP

Grav CMS требует PHP 7.1 или более поздней версии. Debian имеет PHP версии 7 в репозитории по умолчанию, поэтому вам нужно будет использовать сторонний репозиторий для установки более новой версии.

sudo apt install apt-transport-https lsb-release ca-certificates
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

Установите PHP 7.2, а также необходимые расширения PHP:

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php7.2-json php7.2-mbstring php7.2-xml php7.2-zip php7.2-opcache php-apcu

Проверьте версию PHP:

php --version

# PHP 7.2.18-1+0~20190503103213.21+stretch~1.gbp101320 (cli) (built: May  3 2019 10:32:13) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.2.18-1+0~20190503103213.21+stretch~1.gbp101320, Copyright (c) 1999-2018, by Zend Technologies

Служба PHP-FPM автоматически запускается и включается при перезагрузке системы Debian 9, поэтому нет необходимости запускать и включать ее вручную. Мы можем перейти к следующему шагу – настройке SSL.

Шаг 2. Установите клиент Acme.sh и получите сертификат Lets Encrypt (необязательно)

Защита вашего веб-сайта с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить сертификат TLS от Lets Encrypt, мы будем использовать клиент Acme.sh. Acme.sh — это чистое программное обеспечение оболочки Unix для получения сертификатов TLS от Lets Encrypt без каких-либо зависимостей.

Загрузите и установите Acme.sh:

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail 
cd ~

Проверьте версию Acme.sh:

/etc/letsencrypt/acme.sh --version
# v2.8.0

Получите сертификаты RSA и ECC/ECDSA для своего домена/имени хоста:<br>

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048
# ECDSA
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

После выполнения приведенных выше команд ваши сертификаты и ключи будут в:

  • Для RSA: каталог /etc/letsencrypt/example.com.
  • Для ECC/ECDSA: каталог /etc/letsencrypt/example.com_ecc.

Шаг 3. Установите и настройте NGINX

Установите веб-сервер NGINX:

sudo apt install -y nginx

Проверьте версию NGINX:

nginx -v
# nginx version: nginx/1.10.3

Запустите sudo vim /etc/nginx/sites-available/grav.conf и заполните файл следующей конфигурацией:

server {
  
  listen 80;

  server_name example.com;
  root /var/www/grav;
  
  index index.html index.php;
  
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  
  location ~* /(\.git|cache|bin|logs|backup|tests)/.*$ { return 403; }
  location ~* /(system|vendor)/.*\.(txt|xml|md|html|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ { return 403; }
  location ~* /user/.*\.(txt|md|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ { return 403; }
  location ~ /(LICENSE\.txt|composer\.lock|composer\.json|nginx\.conf|web\.config|htaccess\.txt|\.htaccess) { return 403; }

  location ~ \.php$ {
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
  }

}

Активируйте новую конфигурацию grav.conf, связав файл с каталогом sites-enabled.

sudo ln -s /etc/nginx/sites-available/grav.conf /etc/nginx/sites-enabled

Проверьте конфигурацию NGINX на наличие синтаксических ошибок:

sudo nginx -t

Перезагрузите сервис NGINX:

sudo systemctl reload nginx.service

Шаг 4. Установите Grav CMS

Создайте корневой каталог документа, в котором должен находиться Grav:

sudo mkdir -p /var/www/grav

Измените владельца каталога /var/www/grav на {your_user}. Замените {your_user} в приведенной ниже команде именем пользователя, под которым вы сейчас вошли в Debian.:

sudo chown -R {your_user}:{your_user} /var/www/grav

Перейдите в корневой каталог документа:

cd /var/www/grav

Загрузите последнюю версию с официальной страницы и распакуйте zip-файл:

wget https://getgrav.org/download/core/grav-admin/1.6.9
unzip 1.6.9
mv grav-admin/* . && mv grav-admin/.* .
rm -rf grav-admin 1.6.9

ПРИМЕЧАНИЕ. Обновите URL загрузки, если есть более новая версия.

Измените владельца каталога /var/www/grav на www-data:

sudo chown -R www-data:www-data /var/www/grav

Шаг 5. Завершите настройку Grav.

Откройте свой сайт в веб-браузере, и вы должны увидеть страницу с просьбой создать учетную запись администратора Grav. Создайте его и нажмите кнопку \Создать пользователя\:

Вот и все. Ваша установка Grav завершена.

Ссылки

  • https://getgrav.org/
  • https://github.com/getgrav/grav