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

agosto 23, 2023

Shopware es la próxima generación de software de comercio electrónico de código abierto. Basado en tecnologías punteras como Symfony 3, Doctrine2y 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 Shopware Community Edition (CE) en el sistema FreeBSD 12 utilizando NGINX como servidor web.

Requisitos

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

Sistema operativo basado en Linux con servidor web 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 cron jobs.
Mínimo de 4 GB de espacio disponible en el disco duro.
IonCube Loader versión 5.0.0 o superior(opcional).

NOTA: Shopware 5 es actualmente compatible con PHP 7.2.x.

Requisitos previos

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

En este tutorial utilizaré el nombre de dominio ejemplo.com. Sustituye la palabra ejemplo.com por tu propio nombre de dominio siempre que aparezca en los siguientes comandos y archivos de configuración (especialmente en el archivo de configuración de Nginx y en los comandos de Let’s encrypt).

Pasos iniciales

Comprueba tu versión de FreeBSD:

uname -ro
# FreeBSD 12.0-RELEASE

Configura la zona horaria:

tzsetup

Actualiza los paquetes (software) de tu sistema operativo. Este es un primer paso importante porque te asegura que tienes las últimas actualizaciones y correcciones de seguridad de los paquetes de software por defecto 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 las extensiones PHP

Instala PHP, así como las extensiones 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 PHP compilado en módulos, puedes ejecutar:

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Comprueba 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

Iniciar y habilitar 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 ahora sin IonCube, pero aún puede haber extensiones o temas que utilicen 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

Busca el directorio de extensiones 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 PHP:

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

Incluye el cargador mediante la configuración PHP:

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

Añade una línea en el archivo para incluir el cargador ionCube. Puede estar en cualquier parte del archivo por 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

Comprueba 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 MariaDB:

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

Ejecuta el script mysql_secure installation para mejorar la seguridad de MariaDB y establece la contraseña para el usuario de MariaDB root :

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

Sustituye dbname, username y password por tus propios nombres.

Paso 4 – 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 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 pkg install -y acme.sh

Comprueba 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 quieres certificados falsos para hacer pruebas, puedes añadir la bandera --staginga 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. Utilizaremos un directorio /etc/letsencrypt.

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

Instalar/copiar 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 service nginx reload"

Todos los certificados se renovarán automáticamente cada 60 días.

Tras 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

Comprueba la versión de NGINX:

nginx -v
# nginx version: nginx/1.14.2

Inicia y habilita el servicio NGINX:

sudo sysrc nginx_enable=yes
sudo service nginx start

Configura Nginx para Shopware ejecutando:

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

Y rellena 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 añade la siguiente línea al bloque http {} para incluir la configuración de Shopware.

include shopware.conf;

Comprueba si hay errores de sintaxis en la configuración de Nginx:

sudo nginx -t

Recarga el servicio 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 hasta el directorio raíz del documento:

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 establecido en el archivo /usr/local/etc/php.ini:

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

Después de hacer cambios en el archivo /etc/php/7.2/fpm/php.ini, vuelve a cargar 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 ejemplo: http://example.com/backend.

Paso 7 – Completa la instalación de Shopware

Empieza seleccionando el idioma y haz clic en Siguiente:

Asistente de instalación Shopware

A continuación, asegúrate de que cumples todos los requisitos de Shopware:

Requisitos del sistema Shopware

Acepta las condiciones de servicio de Shopware y pulsa Siguiente:

Condiciones de servicio de ShopWare

Introduce las credenciales de la base de datos y pulsa Siguiente:

Configura la base de datos

Inicia la instalación para crear las tablas de la base de datos:

Crear tablas de base de datos

Después, verás un mensaje sobre la importación correcta de la base de datos:

Instalación correcta

Elige una licencia y haz clic en Siguiente:

Licencias

Rellena algunos ajustes básicos para finalizar la instalación y haz clic en Siguiente:

Configuración básica de la tienda

La instalación ha finalizado.

Instalación completa

Para acceder al área de administración, añade /backend a tu URL.

Acceso a Shopware

Has instalado Shopware correctamente. ¡Disfruta de tu nueva tienda online!

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

Requisitos

Requisitos previos

Pasos iniciales

Paso 1 – Instalar PHP y las extensiones PHP

Paso 2 – Instalar IonCube Loader (opcional)

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

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

Paso 5 – Instalar y configurar NGINX

Paso 6 – Instalar Shopware

Paso 7 – Completa la instalación de Shopware

Enlaces

También te podría gustar...

Entradas recientes

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

Requisitos

Requisitos previos

Pasos iniciales

Paso 1 – Instalar PHP y las extensiones PHP

Paso 2 – Instalar IonCube Loader (opcional)

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

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

Paso 5 – Instalar y configurar NGINX

Paso 6 – Instalar Shopware

Paso 7 – Completa la instalación de Shopware

Enlaces

También te podría gustar...

Activar la compatibilidad con UEFI en la virtualización KVM

Tutorial de programación en C para Linux Parte 25 – Punteros de función

Cómo instalar y crear un servidor de chat utilizando Matrix Synapse y Element en Ubuntu 22.04

Entradas recientes