Cómo instalar Shopware con NGINX y Let’s encrypt en Ubuntu 18.04 LTS
Shopware es la próxima generación de software de comercio electrónico de código abierto. Basado en tecnologías de vanguardia comoSymfony 3,Doctrine 2
yZend Framework,Shopware se presenta como la plataforma perfecta para tu próximo proyectode comercio electrónico.Este tutorial te guiará en la instalación de Shopware Community Edition (CE) en el sistema Ubuntu 18.04 LTS utilizando NGINX como servidor web.
Requisitos
Asegúrate de que tu sistema cumple los siguientesrequisitos mínimos
- Sistema operativo basado en Linux con servidor web NGINX o Apache 2.x (conmod_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.
- Un mínimo de 4 GB de espacio disponible en el disco duro.
- IonCube Loader versión 5.0.0 o superior(opcional).
NOTA: Shopware es actualmente compatible con PHP 7.2.x.
Requisitos previos
- Un sistema operativo con Ubuntu 18.04 LTS.
- Un usuario no root con privilegios sudo.
Pasos iniciales
Comprueba tu versión de Ubuntu:
lsb_release -ds
# Ubuntu 18.04.2 LTS
Configura la zona horaria:
sudo dpkg-reconfigure tzdata
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 apt update && sudo apt upgrade -y
Instala algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo Ubuntu:
sudo apt install -y curl wget vim git unzip socat bash-completion
Paso 1 – Instalar PHP y las extensiones de PHP
Instala PHP, así como las extensiones PHP necesarias para Shopware:
sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mysql php7.2-curl php7.2-json php7.2-zip php7.2-gd php7.2-xml php7.2-mbstring php7.2-opcache
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.17-0ubuntu0.18.04.1 (cli) (built: Apr 18 2019 14:12:38) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.2.17-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies
El servicio PHP-FPM se inicia y habilita automáticamente al reiniciar el sistema Ubuntu 18.04, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es la instalación de IonCube Loader.
Paso 2 – Instalar IonCube Loader(opcional)
Descarga IonCube Loader:
cd /tmp && wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
Extrae el cargador:
tar xfz ioncube_loaders_lin_*.gz
Busca el directorio de extensiones de PHP en el sistema ejecutando el siguiente comando:
php -i | grep extension_dir
# extension_dir => /usr/lib/php/20170718 => /usr/lib/php/20170718
Copia el ionCube Loader en el directorio de extensiones de PHP:
sudo cp /tmp/ioncube/ioncube_loader_lin_7.2.so /usr/lib/php/20170718/
Incluye el cargador a través de la configuración de PHP:
sudo vim /etc/php/7.2/fpm/php.ini
A continuación, añade una línea en el archivo para incluir el cargador ionCube. Puede estar en cualquier lugar del archivo por debajo de la línea[PHP]
:
zend_extension = /usr/lib/php/20170718/ioncube_loader_lin_7.2.so
Guarda el archivo y reinicia el PHP-FPM:
sudo systemctl restart php7.2-fpm.service
Paso 3 – Instalar MySQL y crear una base de datos para Shopware
Instala el servidor de bases de datos MySQL:
sudo apt install -y mysql-server
Comprueba la versión de MySQL:
mysql --version
# mysql Ver 14.14 Distrib 5.7.26, for Linux (x86_64) using EditLine wrapper
Ejecuta el scriptmysql_secure installation
script para mejorar la seguridad de MySQL y establecer la contraseña de MySQLroot
:
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 MySQL como usuario root:
sudo mysql -u root -p
# Enter password
Crea una base de datos MySQL 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 MySQL:
mysql> exit
Sustituyedbname
,username
ypassword
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 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.1
Obtén certificadosRSAyECC/ECDSApara 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, tuscertificados yclaves estarán en:
- ParaRSA:
/home/username/example.com
directorio. - ParaECC/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 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 5 - Instalar y configurar NGINX
Instala el servidor web NGINX:
sudo apt install -y nginx
Comprueba la versión de NGINX:
sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)
ConfiguraNGINXpara Shopware. Ejecutasudo vim /etc/nginx/sites-available/shopware.conf
y añade la siguiente configuración:
server {
listen 80;
listen [::]:80;
server_name example.com;
root /var/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 snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
}
}
Activa la nueva configuración deshopware.conf
vinculando el archivo al directoriosites-enabled
:
sudo ln -s /etc/nginx/sites-available/shopware.conf /etc/nginx/sites-enabled
CompruebaNGINXen busca de errores de sintaxis:
sudo nginx -t
RecargaNGINX:
sudo systemctl reload nginx.service
Paso 6 - Instalar Shopware
Crea un directorio raíz de documentos para Shopware:
sudo mkdir -p /var/www/shopware
Cambia la propiedad del/var/www/shopware
a{usuario_de_la_familia}:
sudo chown -R {your_user}:{your_user} /var/www/shopware
Navega hasta el directorio raíz del documento:
cd /var/www/shopware
Descarga y descomprime la últimaversión de Shopware mediante wget:
wget https://releases.shopware.com/install_5.5.8_d5bf50630eeaacc6679683e0ab0dcba89498be6d.zip?_ga=2.141661361.269357371.1556739808-1418008019.1556603459 -O shopware.zip
unzip shopware.zip
rm shopware.zip
NOTA:Actualiza la URL de descarga si hay una versión más reciente.
Cambia la propiedad del directorio/var/www/shopware
awww-data
.
sudo chown -R www-data:www-data /var/www/shopware
Aumentamemory_limit = 256M
yupload_max_filesize = 6M
, y estableceallow_url_fopen = On
si no está ya establecido en el archivo/etc/php/7.2/fpm/php.ini
.
sudo vim /etc/php/7.2/fpm/php.ini
Después de hacer los cambios en el archivo/etc/php/7.2/fpm/php.ini
, vuelve a cargarphp7.2-fpm.service:
sudo systemctl reload php7.2-fpm.service
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 configuración de Shopware
Empieza por seleccionar el idioma y haz clic en Siguiente:
A continuación, asegúrate de que cumples todos los requisitos de Shopware:
Acepta las condiciones de servicio de Shopware y haz clic en Siguiente:
Introduce las credenciales de la base de datos y haz clic en Siguiente:
Inicia la instalación para crear las tablas de la base de datos:
Después, verás un mensaje sobre la importación exitosa de la base de datos:
Elige una licencia y haz clic en Siguiente:
Rellena algunos ajustes básicos para terminar la instalación y haz clic en Siguiente:
La instalación ha finalizado.
Para acceder al área de administración, añade /backend a tu URL.
Has instalado con éxito Shopware. ¡Disfruta de tu nueva tienda online!