Grav es una plataforma web basada en archivos rápida, simple y flexible. 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
- Dispatcher de eventos de Symfony:para el manejo de eventos de complementos
- Consola Symfony:para interfaz CLI
- Biblioteca de imágenes Gregwar: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 Grav CMS en el sistema operativo Debian 9 usando 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 PHP: curl, ctype, dom, gd, json, mbstring, openssl, session, simplexml, xml, zip, apcu(opcional), opcache(opcional).
Requisitos
- 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 la versión de PHP 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 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 asegurar 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.
Descarga e instala 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 ~
Comprobar la versión 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 teclas estará en:
- Para RSA :
/etc/letsencrypt/example.comdirectorio. - Para ECC/ECDSA :
/etc/letsencrypt/example.com_eccdirectorio.
Paso 3:instalar y configurar NGINX
Instale el servidor web NGINX:
sudo apt install -y nginx
Comprueba 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 el nuevo grav.conf configuración vinculando el archivo a sites-enabled directorio.
sudo ln -s /etc/nginx/sites-available/grav.conf /etc/nginx/sites-enabled
Comprueba la configuración de NGINX para ver si hay 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 en el que Grav deba residir:
sudo mkdir -p /var/www/grav
Cambiar la propiedad de /var/www/grav directorio a {su_usuario}. Reemplace {su_usuario} en el siguiente comando con el nombre de usuario con el que ha iniciado sesión actualmente en Debian.:
sudo chown -R {your_user}:{your_user} /var/www/grav Navegue al directorio raíz del documento:
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
Cambiar la propiedad del /var/www/grav directorio 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. Tu instalación de Grav está completa.
Enlaces
- https://getgrav.org/
- https://github.com/getgrav/grav