Cómo instalar Grav CMS con Nginx en Debian 9

Grav es una plataforma web rápida, simple y flexible basada en archivos. Sigue principios similares a otras plataformas CMS de archivo plano, pero tiene una filosofía de diseño diferente a la de la mayoría. Grav viene con un poderoso sistema de administración de paquetes que permite una instalación y actualización simples de complementos y temas, así como una actualización simple de Grav.

La arquitectura subyacente de Grav está diseñada para usar tecnologías bien establecidas y de primera clase para garantizar que Grav sea fácil de usar y fácil de ampliar. Algunas de estas tecnologías clave incluyen:

• Twig Templating: para un control potente de la interfaz de usuario
• Markdown: para una fácil creación de contenido
• YAML: para una configuración sencilla
• Parsedown: para soporte rápido de Markdown y Markdown Extra
• Doctrine Cache: capa para el rendimiento
• Contenedor de inyección de dependencia Pimple: para extensibilidad y mantenibilidad
• Symfony Event Dispatcher: para el manejo de eventos de complementos
• Consola Symfony: para interfaz CLI
• Gregwar Image Library: para la manipulación dinámica de imágenes

En esta guía, lo guiaremos paso a paso a través del proceso de instalación de Grav CMS en el sistema operativo Debian 9 utilizando Nginx como servidor web y acme.sh y Let’s Encrypt para HTTPS.

Requisitos

• Servidor web (Apache, Nginx, LiteSpeed, Lightly o IIS). En esta guía, usaremos NGINX.
• PHP 7.1.3 o superior con las siguientes extensiones de PHP: curl, ctype, dom, gd, json, mbstring, openssl, session, simplexml, xml, zip, apcu (opcional), opcache (opcional).

• Un sistema operativo que ejecuta Debian 9.
• Un usuario no root con privilegios sudo.

Pasos iniciales

Compruebe su versión de Debian:

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

Configurar la zona horaria:

sudo dpkg-reconfigure tzdata

Actualice los paquetes de su sistema operativo (software). Este es un primer paso importante porque garantiza que tenga las últimas actualizaciones y correcciones de seguridad para los paquetes de software predeterminados de su sistema operativo:

sudo apt update && sudo apt upgrade -y

Instale algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo Debian:

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

Paso 1 – Instalar PHP y extensiones de PHP

Grav CMS requiere PHP versión 7.1 o superior. Debian tiene la versión 7 de PHP en el repositorio predeterminado, por lo que deberá usar un repositorio de terceros para instalar una versión más nueva.

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

Instale PHP 7.2, así como las extensiones de PHP necesarias:

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

Compruebe la versión de 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

El servicio PHP-FPM se inicia y habilita automáticamente al reiniciar en el sistema Debian 9, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es la configuración de SSL.

Paso 2: instale el cliente Acme.sh y obtenga el certificado Let’s Encrypt (opcional)

No es necesario proteger su sitio web con HTTPS, pero es una buena práctica para proteger el tráfico de su sitio. Para obtener el certificado TLS de Let’s Encrypt, utilizaremos el cliente Acme.sh. Acme.sh es un software de shell Unix puro para obtener certificados TLS de Let’s Encrypt sin dependencias.

Descargue e instale 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 [email protected]
cd ~

Compruebe la versión de Acme.sh:

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

Obtener RSA y ECC/ECDSA certificados para su dominio/nombre de host:

# 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

Después de ejecutar los comandos anteriores, sus certificados y claves estarán en:

• Para RSA: directorio /etc/letsencrypt/example.com.
• Para ECC/ECDSA: directorio /etc/letsencrypt/example.com_ecc.

Paso 3: instalar y configurar NGINX

Instale el servidor web NGINX:

sudo apt install -y nginx

Compruebe la versión de NGINX:

nginx -v
# nginx version: nginx/1.10.3

Ejecute sudo vim /etc/nginx/sites-available/grav.conf y complete el archivo con la siguiente configuración:

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;
  }

}

Active la nueva configuración de grav.conf vinculando el archivo al directorio habilitado para sitios.

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

Verifique la configuración de NGINX para errores de sintaxis:

sudo nginx -t

Recargar servicio NGINX:

sudo systemctl reload nginx.service

Paso 4 – Instalar Grav CMS

Cree un directorio raíz de documentos donde Grav debería residir:

sudo mkdir -p /var/www/grav

Cambie la propiedad del directorio /var/www/grav a {su_usuario}. Reemplace {su_usuario} en el siguiente comando con el nombre de usuario con el que está actualmente conectado a Debian.:

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

Navegue al directorio raíz del documento: Anuncio

cd /var/www/grav

Descarga la última versión de la página oficial y extrae el archivo 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

NOTA: Actualice la URL de descarga si hay una versión más reciente.

Cambie la propiedad del directorio /var/www/grav a www-data:

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

Paso 5: completa la configuración de Grav

Abra su sitio en un navegador web y debería ver una página que le pide que cree una cuenta de administrador de Grav. Cree uno y continúe haciendo clic en el botón «Crear usuario»:

Eso es todo. Su instalación de Grav está completa.

Enlaces