Cómo instalar Shopware con NGINX y Let's Encrypt en FreeBSD 12

Shopware es la próxima generación de software de comercio electrónico de código abierto. Basado en tecnologías de vanguardia como Symfony 3, Doctrine 2 y Zend Framework, Shopware se presenta como la plataforma perfecta para tu próximo proyecto de comercio electrónico. Este tutorial te guiará a través de la instalación de la edición comunitaria de Shopware (CE) en un sistema FreeBSD 12 utilizando NGINX como servidor web.

Requisitos

Asegúrate de que tu sistema cumpla con los siguientes requisitos mínimos:

Sistema operativo basado en Linux con NGINX o Apache 2.x (con mod_rewrite) instalado.
PHP 5.6.4 o superior con las extensiones ctype, gd, curl, dom, hash, iconv, zip, json, mbstring, openssl, session, simplexml, xml, zlib, fileinfo y pdo/mysql. Se recomienda encarecidamente PHP 7.1 o superior.
MySQL 5.5.0 o superior.
Posibilidad de configurar trabajos cron.
Mínimo 4 GB de espacio en disco duro disponible.
IonCube Loader versión 5.0.0 o superior ( opcional).

*NOTA: Shopware 5 es actualmente compatible hasta PHP 7.2.x.*

Prerrequisitos

Un sistema operativo que ejecute FreeBSD 12.
Un usuario no root con privilegios sudo.

Utilizaré el nombre de dominio example.com en este tutorial. Por favor, reemplaza la palabra example.com con tu propio nombre de dominio dondequiera que aparezca en los comandos y archivos de configuración a continuación (especialmente en el archivo de configuración de Nginx y los comandos de Let’s Encrypt).

Pasos iniciales

Verifica tu versión de FreeBSD:

uname -ro  
# FreeBSD 12.0-RELEASE

Configura la zona horaria:

tzsetup

Actualiza los paquetes de tu sistema operativo (software). Este es un primer paso importante porque asegura que tengas las últimas actualizaciones y correcciones de seguridad para los paquetes de software predeterminados de tu sistema operativo:

freebsd-update fetch install  
pkg update && pkg upgrade -y

Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash socat

Paso 1 - Instalar PHP y extensiones de PHP

Instala PHP, así como las extensiones de PHP necesarias para Shopware:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Para mostrar los módulos compilados en PHP, puedes ejecutar:

php -m  
  
ctype  
curl  
exif  
fileinfo  
. . .  
. . .

Verifica la versión de PHP:

php --version  
  
# PHP 7.2.16 (cli) (built: Apr 30 2019 08:37:17) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.5, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.5, Copyright (c) 1999-2018, by Zend Technologies

Inicia y habilita el servicio PHP-FPM:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Podemos pasar al siguiente paso, que es la instalación de IonCube Loader.

Paso 2 - Instalar IonCube Loader (opcional)

Este paso es opcional porque Shopware funciona sin IonCube ahora, pero puede haber extensiones o temas que usen IonCube, así que no está de más instalarlo. Descarga IonCube Loader:

cd /tmp && wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_fre_11_x86-64.tar.gz

Extrae el cargador:

tar xfz ioncube_loaders_fre_*.tar.gz

Encuentra el directorio de extensiones de PHP en el sistema ejecutando el siguiente comando:

php -i | grep extension_dir  
# extension_dir => /usr/local/lib/php/20170718 => /usr/local/lib/php/20170718

Copia el IonCube Loader en el directorio de extensiones de PHP:

sudo cp /tmp/ioncube/ioncube_loader_fre_7.2.so /usr/local/lib/php/20170718

Incluye el cargador a través de la configuración de PHP:

sudo vim /usr/local/etc/php.ini

Luego agrega una línea en el archivo para incluir el cargador de ionCube. Puede estar en cualquier lugar del archivo debajo de la línea [PHP]:

zend_extension = /usr/local/lib/php/20170718/ioncube_loader_fre_7.2.so

Guarda el archivo y reinicia PHP-FPM:

sudo service php-fpm restart

Paso 3 - Instalar MariaDB y crear una base de datos para Shopware

Instala el servidor de base de datos MariaDB:

sudo pkg install -y mariadb102-client mariadb102-server

Verifica la versión de MariaDB:

mysql --version  
# mysql  Ver 15.1 Distrib 10.2.23-MariaDB, for Linux (x86_64) using readline 5.1

Inicia y habilita el servicio de MariaDB:

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

Ejecuta el script mysql_secure_installation para mejorar la seguridad de MariaDB y establecer la contraseña para el usuario root de MariaDB:

sudo mysql_secure_installation

Responde a cada una de las preguntas:

`¿Te gustaría configurar el plugin VALIDATE PASSWORD? N  
Nueva contraseña: tu_contraseña_segura  
Reingresa nueva contraseña: tu_contraseña_segura  
¿Eliminar usuarios anónimos? [Y/n] Y  
¿Deshabilitar el inicio de sesión remoto de root? [Y/n] Y  
¿Eliminar la base de datos de prueba y el acceso a ella? [Y/n] Y  
¿Recargar las tablas de privilegios ahora? [Y/n] Y`

Conéctate a la consola de MariaDB como el usuario root:

sudo mysql -u root -p  
# Ingresa la contraseña

Crea una base de datos vacía de MariaDB y un usuario para Shopware y recuerda las credenciales:

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

Sal de MariaDB:

mysql> exit

Reemplaza dbname, username y password con tus propios nombres.

Paso 4 - Instalar el cliente Acme.sh y obtener el certificado de Let’s Encrypt (opcional)

Asegurar tu sitio web con HTTPS no es necesario, pero es una buena práctica 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 sin dependencias.

Descarga e instala acme.sh:

sudo pkg install -y acme.sh

Verifica la versión de acme.sh:

acme.sh --version  
# v2.8.2

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 deseas certificados falsos para pruebas, puedes agregar la bandera --staging a los comandos anteriores.

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

Para RSA: directorio /home/username/example.com.
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. Usaremos un directorio /etc/letsencrypt.

`mkdir -p /etc/letsecnrypt/example.com`  
`sudo mkdir -p /etc/letsencrypt/example.com_ecc`

Instala/copia los certificados en el directorio /etc/letsencrypt.

# 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 service nginx reload"

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 5 - Instalar y configurar NGINX

Instala el servidor web NGINX:

sudo pkg install -y nginx

Verifica la versión de NGINX:

nginx -v  
# nginx version: nginx/1.14.2

Inicia y habilita el servicio de NGINX:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Configura Nginx para Shopware ejecutando:

sudo vim /usr/local/etc/nginx/shopware.conf

Y llena el archivo con la siguiente configuración:

server {
    listen 80;
    listen [::]:80;
    
    server_name example.com;
    root /usr/local/www/shopware;

    index shopware.php index.php;

    location / {
        try_files $uri $uri/ /shopware.php$is_args$args;
    }

    location /recovery/install {
      index index.php;
      try_files $uri /recovery/install/index.php$is_args$args;
    }

    location ~ \.php$ {
        include fastcgi.conf;
        fastcgi_pass 127.0.0.1:9000;
    }
}

Ejecuta sudo vim /usr/local/etc/nginx/nginx.conf y agrega la línea a continuación en el bloque http {} para incluir la configuración de Shopware.

include shopware.conf;

Verifica la configuración de Nginx en busca de errores de sintaxis:

sudo nginx -t

Recarga el servicio de Nginx:

sudo service nginx reload

Paso 6 - Instalar Shopware

Crea un directorio raíz de documentos para Shopware:

sudo mkdir -p /usr/local/www/shopware

Navega al directorio raíz de documentos:

cd /usr/local/www/shopware

Descarga y descomprime Shopware:

sudo wget https://releases.shopware.com/install_5.5.8_d5bf50630eeaacc6679683e0ab0dcba89498be6d.zip?_ga=2.141661361.269357371.1556739808-1418008019.1556603459 -O shopware.zip  
sudo unzip shopware.zip  
sudo rm shopware.zip

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

Proporciona la propiedad adecuada:

sudo chown -R www:www /usr/local/www/shopware

Aumenta memory_limit = 256M y upload_max_filesize = 6M, y establece allow_url_fopen = On si no está ya configurado en el archivo /usr/local/etc/php.ini:

sudo vim /usr/local/etc/php.ini

Después de realizar cambios en el archivo /etc/php/7.2/fpm/php.ini, recarga php-fpm.service:

sudo service php-fpm reload

Abre tu dominio/IP en el navegador web y sigue el asistente de instalación. El backend de Shopware se encuentra en /backend, por ejemplo: http://example.com/backend.