Cómo instalar Fork CMS con NGINX en CentOS 8
Fork es un CMS de código abierto fácil de usar construido con componentes Symfony. Tiene una interfaz intuitiva y fácil de usar, potentes aplicaciones que puedes descargar para ampliar tu sitio, yuna amplia colección de hermosos temas. En este tutorial, recorreremos la instalación y configuración del CMS Fork en el sistema CentOS 8 utilizando Nginx como servidor web, MariaDB como motor de base de datos, y opcionalmente puedes asegurar la capa de transporte utilizando el cliente Acme.sh y la autoridad de certificados Let’s Encrypt para añadir soporte SSL.
Requisitos
Los requisitos para instalar y ejecutar Fork CMS son
- PHP versión 7.1 o superior.
- Deben estar instaladas y habilitadas las siguientes extensiones de PHP: cURL, libxml, DOM, SimpleXML, SPL, PDO (con controlador MySQL), mb_string, iconv, biblioteca gráfica GD2, JSON, PCRE, intl.
- MySQL 5.0 o superior.
- NGINX o Apache con
.htaccess
,mod_rewrite
,mod_expires
(opcional pero recomendado),mod_deflate
(opcional) habilitados.
Requisitos previos
- Un sistema operativo con CentOS 8.
- Un usuario no root con privilegios sudo.
Pasos iniciales
Comprueba tu versión de CentOS:
cat /etc/centos-release
# CentOS Linux release 8.0.1905 (Core)
Configura la zona horaria:
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque garantiza que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto de tu sistema operativo:
sudo yum update -y
Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo CentOS:
sudo yum install -y curl wget vim git unzip socat bash-completion epel-release
Paso 1 – Instalar PHP y las extensiones de PHP
Instala PHP, así como las extensiones PHP necesarias para Fork CMS:
sudo yum install -y php php-cli php-fpm php-common php-mysqlnd php-curl php-json php-zip php-gd php-xml php-mbstring php-opcache php-intl
Para mostrar el PHP compilado en módulos, puedes ejecutar:
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Comprobar la versión de PHP:
php --version
# PHP 7.2.11 (cli) (built: Oct 9 2018 15:09:36) ( NTS )
Iniciar y habilitar el servicio PHP-FPM:
sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service
Podemos pasar al siguiente paso, que es la instalación y configuración de la base de datos.
Paso 2 – Instalar MariaDB y crear una base de datos para Fork CMS
Instala el servidor de base de datos MariaDB:
sudo yum install -y mariadb-server
Comprueba la versión de MariaDB:
mysql --version
# mysql Ver 15.1 Distrib 10.3.11-MariaDB, for Linux (x86_64) using readline 5.1
Inicia y activa el servicio MariaDB:
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
Ejecuta el script mysql_secure installation
para mejorar la seguridad de MariaDB y establecer la contraseña del usuario raíz de MariaDB:
sudo mysql_secure_installation
Responde a cada una de las preguntas:
Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y
Conéctate al shell de MariaDB como usuario root:
sudo mysql -u root -p
# Enter password
Crea una base de datos MariaDB vacía y un usuario para Fork CMS y recuerda las credenciales:
mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'mypassword';
mysql> FLUSH PRIVILEGES;
Sustituye la palabra mypassword por una contraseña segura de tu elección. Sal de MariaDB:
mysql> exit
Sustituye dbname,
yusername
por tus propios nombres.
password
Paso 3 – Instalar el cliente Acme.sh y obtener el certificado Let’s Encrypt (opcional)
Asegurar tu sitio web con HTTPS no es necesario, pero es una buena práctica para asegurar el tráfico de tu sitio. Para obtener un certificado SSL 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.2
Obtén los 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 flag to the above commands.
Después de ejecutar los comandos anteriores, tus certificados y claves estarán dentro:
- Para RSA:
/home/username/example.com directory.
- Para ECC/ECDSA:
/home/username/example.com_ecc directory.
Para listar tus certificados emitidos puedes ejecutar:
acme.sh --list
Crea un directorio para almacenar tus certificados. Utilizaremos un directorio /etc/letsencrypt.
mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Instala/copia los certificados en /etc/letsencrypt directorio.
# 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 certs sal del usuario root y vuelve al usuario sudo normal:
exit
Paso 4 - Instalar y configurar NGINX
Instala el servidor web NGINX:
sudo yum install -y nginx
Comprueba la versión de NGINX:
nginx -v
# nginx version: nginx/1.14.1
Configura NGINX para Fork CMS. Ejecuta sudo vim /etc/nginx/conf.d/fork.conf
y añade la siguiente configuración:
server {
listen 80;
listen 443 ssl;
root /var/www/fork;
index index.php index.html;
server_name example.com;
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;
location / {
# Checks whether the requested url exists as a file $uri or directory $uri/ in the root, else redirect to /index.php.
try_files $uri $uri/ @redirects;
}
location @redirects {
rewrite ^ /index.php;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_read_timeout 60;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
# Don't pollute the logs with common requests
location = /robots.txt { access_log off; log_not_found off; }
location = /favicon.ico { access_log off; log_not_found off; }
# As Fork CMS has the app_root as doc_root, we need to restrict access to a few things for security purposes!
location ~* ^/(composer\..*|vendor\/.*|Procfile$|\.git\/.*|src\/Console.*|.*\.gitignore|\.editorconfig|\.travis.yml|autoload\.php|bower\.json|phpunit\.xml\.dist|.*\.md|app\/logs\/.*|app\/config\/.*|src\/Frontend\/Cache\/CompiledTemplates.*|src\/Frontend\/Cache\/Locale\/.*\.php|src\/Frontend\/Cache\/Navigation\/.*\.php|src\/Frontend\/Cache\/Search\/.*|src\/Backend\/Cache\/CompiledTemplates\/.*|src\/Backend\/Cache\/Locale\/.*\.php)$ {
deny all;
access_log off;
log_not_found off;
}
# Deny access to dot-files.
location ~ /\. {
deny all;
access_log off;
log_not_found off;
}
}
Comprueba que la configuración de NGINX no tenga errores de sintaxis:
sudo nginx -t
Recarga el servicio NGINX:
sudo systemctl reload nginx.service
Paso 5 - 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.9.0 2019-08-02 17:46:47
Paso 6 - Instalar Fork CMS
Crea un directorio raíz de documentos.
sudo mkdir -p /var/www/fork
Cambia la propiedad del directorio /var/www/fork
al usuario con el que estés conectado actualmente, en mi caso, este nombre de usuario es johndoe
.
sudo chown -R johndoe:johndoe /var/www/fork
Sustituye johndoe por tu nombre de usuario en el comando anterior. Descarga la última versión estable de Fork CMS desde la línea de comandos.
cd /var/www/fork
composer create-project forkcms/forkcms .
Cambia la propiedad del directorio /var/www/fork
a www-data
.
sudo chown -R nginx:nginx /var/www/fork
Edita el archivo app/config/parameters.yml.dist
y establece la información de la base de datos.
sudo vim /var/www/fork/app/config/parameters_install.yml
Ejecuta sudo vim /etc/php-fpm.d/www.conf
y establece el usuario y el grupo como nginx:
sudo vim /etc/php-fpm.d/www.conf
Crea el directorio /var/lib/php/session
y cambia su propiedad a usuario nginx:
sudo mkdir -p /var/lib/php/session
sudo chown -R nginx:nginx /var/lib/php/session
Reinicia php-fpm.service:
sudo systemctl restart php-fpm.service
Utilizando tu navegador web preferido, abre tu sitio y sigue el instalador de Fork CMS. Después de seguir el instalador deberías tener Fork en funcionamiento. Para acceder al área de administración de Fork sólo tienes que añadir /private
a la URL de tu sitio.
Paso 7 - Completa la instalación de Fork CMS
Asegúrate de que tu servidor cumple todos los requisitos y continúa:
Selecciona el idioma y haz clic en siguiente:
Selecciona la configuración que desees y haz clic en siguiente:
Introduce la configuración de tu base de datos y haz clic en siguiente. Asegúrate de que ya has creado la base de datos.
Crea el usuario y termina la instalación:
Verás la siguiente página después de completar todos los pasos anteriores:
Has instalado con éxito Fork CMS. ¡Disfruta de tu nuevo CMS!