Cómo instalar Pico CMS con Nginx en Debian 10
Pico es un CMS de código abierto, sencillo y rápido, escrito en PHP. Esto significa que no hay que ocuparse del backend de administración ni de la base de datos. Simplemente creas archivos .md en la carpeta de contenido, y eso se convierte en una página. Pico utiliza el motor de plantillas Twig para obtener temas potentes y flexibles. El código fuente de Pico está disponible en Github. En este tutorial, instalaremos Pico CMS con Nginx en el sistema Debian 10 (buster).
Requisitos
Los requisitos para ejecutar Pico son
- Nginx
- Versión de PHP 5.3.6 o superior
- Compositor
Requisitos previos
- Sistema operativo Debian 10 (buster).
- Un usuario no root con privilegios en
sudo
.
Pasos iniciales
Comprueba tu versión de Debian:
lsb_release -ds # Debian GNU/Linux 10 (buster)
Configura la zona horaria:
sudo dpkg-reconfigure tzdata
Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso esencial porque garantiza que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto de tu sistema operativo:
sudo apt update && sudo apt upgrade -y
Instala 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 bash-completion apt-transport-https
Paso 1 – Instalar PHP
Instala PHP, así como las extensiones PHP necesarias:
sudo apt install -y php7.3 php7.3-cli php7.3-fpm php7.3-common php7.3-curl php7.3-gd php7.3-json php7.3-zip php7.3-xml php7.3-mbstring
Para mostrar el PHP compilado en módulos, puedes ejecutar:
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Comprueba la versión de PHP:
php --version
# PHP 7.3.4-2 (cli) (built: Apr 13 2019 19:05:48) ( NTS ) # Copyright (c) 1997-2018 The PHP Group # Zend Engine v3.3.4, Copyright (c) 1998-2018 Zend Technologies # with Zend OPcache v7.3.4-2, Copyright (c) 1999-2018, by Zend Technologies
El servicio PHP-FPM se inicia y habilita automáticamente al reiniciar el sistema Debian 10, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es la instalación y configuración de la base de datos.
Paso 2 – Instalar el cliente acme.sh
y obtener el certificado Let’s Encrypt(opcional)
Asegurar tu foro con HTTPS no es necesario, pero es una buena práctica para asegurar el tráfico de tu sitio. Para obtener un 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 con cero dependencias.
Descarga e instala acme.sh:
sudo su - root git clone https://github.com/Neilpang/acme.sh.git cd acme.sh ./acme.sh --install --accountemail [email protected] source ~/.bashrc cd ~
Comprueba la versión de acme.sh:
acme.sh --version # v2.8.0
Obtén certificados RSA y ECC/ECDSA para tu dominio/nombre de host:
# RSA 2048 acme.sh --issue --standalone -d example.com --keylength 2048 # ECDSA acme.sh --issue --standalone -d example.com --keylength ec-256
Si quieres certificados falsos para hacer pruebas, puedes añadir --staging
a los comandos anteriores.
Después de ejecutar los comandos anteriores, tus certificados y claves estarán en:
- Para RSA:
/home/username/example.com
directorio. - Para ECC/ECDSA: directorio
/home/username/example.com_ecc
.
Para listar tus certificados emitidos puedes ejecutar:
acme.sh --list
Crea un directorio para almacenar tus certificados. Nosotros utilizaremos el directorio /etc/letsencrypt
.
mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Instala/copia los certificados en/etc/letsencryptdirectorio.
# RSA acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service" # ECC/ECDSA acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
Todos los certificados se renovarán automáticamente cada 60 días.
Después de obtener los certificados sal del usuario root y vuelve al usuario sudo normal:
exit
Paso 3 – Instalar y configurar NGINX
Instala NGINX:
sudo apt install -y nginx
Comprueba la versión de NGINX:
sudo nginx -v # nginx version: nginx/1.14.2
A continuación, configura NGINX para Pico CMS. Ejecuta sudo vim /etc/nginx/sites-available/pico.conf
y añade la siguiente configuración.
server {
listen 80;
listen 443 ssl;
server_name example.com;
root /var/www/pico;
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
index index.php;
location ~ ^/((config|content|vendor|composer\.(json|lock|phar))(/|$)|(.+/)?\.(?!well-known(/|$))) {
deny all;
}
location / {
index index.php;
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_index index.php;
fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_param PICO_URL_REWRITING 1;
}
}
Activa la nueva configuración de pico.conf
vinculando el archivo al directorio sites-enabled
:
sudo ln -s /etc/nginx/sites-available/pico.conf /etc/nginx/sites-enabled
CompruebaNGINX en busca de errores de sintaxis:
sudo nginx -t
RecargaNGINX :
sudo systemctl reload nginx.service
Paso 4 – Instalar Composer
Instala Composer, el gestor de dependencias de PHP de forma global:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r «if (hash_file(‘sha384’, ‘composer-setup.php’) === ‘a5c698ffe4b8e849a443b120cd5ba38043260d5c4023dbf93e1558871f1f07f58274fc6f4c93bcfd858c6bd0775cd8d1’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;»
php composer-setup.php
php -r «unlink(‘composer-setup.php’);»
sudo mv composer.phar /usr/local/bin/composer
Comprueba la versión de Composer:
composer --version # Composer version 1.8.6 2019-06-11 15:03:05
NOTA: Los comandos de instalación de Composer cambiarán en el futuro, así que comprueba en https://getcomposer.org/download/ los comandos más actualizados si los anteriores no funcionan.
Paso 5 – Instalar Pico CMS
Crea un directorio raíz de documentos para Pico CMS:
sudo mkdir -p /var/www/pico
Cambia la propiedad del directorio /var/www/pico
a [your_username]
:
sudo chown -R [your_username]:[your_username] /var/www/pico
Sustituye [tu_nombre_de_usuario] en el comando anterior por el nombre de usuario de Linux con el que estás conectado actualmente.
A continuación, navega hasta el directorio raíz del documento:
cd /var/www/pico
Descarga Pico con compositor:
composer create-project picocms/pico-composer .
Cambia la propiedad del directorio /var/www/pico
al directorio www-data:
sudo chown -R www-data:www-data /var/www/pico
Has instalado con éxito Pico CMS en el sistema Debian 10 (buster). Ahora puedes simplemente crear tu propia carpeta de contenido en el directorio raíz de Pico, crear archivos .md en el directorio de contenido y esos archivos se convertirán en tus páginas.