HowtoForge

Tutoriales de Linux

Cómo instalar X-Cart con Nginx y Let’s Encrypt SSL en Ubuntu 18.04 LTS

X-Cart es una plataforma de comercio electrónico de código abierto extremadamente flexible, con una amplia gama de funciones e integraciones. El código fuente de X-Cart está alojado en Github. Esta guía describe el proceso de instalación de X-Cart 5 en Ubuntu 18.04 LTS utilizando Nginx como servidor web y MySQL como servidor de base de datos, y cómo proteger la instalación con un certificado SSL gratuito de Let’s encrypt.

Requisitos

  • PHP versión 7.2 o superior
  • Extensiones PHP: pdo, phar, mysql, mbstring, curl
  • MySQL versión 5.7.7 o superior o equivalente MariaDB
  • Nginx

Pasos iniciales

Comprueba tu versión de Ubuntu:

lsb_release -ds
# Ubuntu 18.04.4 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 dispones de las últimas actualizaciones y correcciones de seguridad de los paquetes de software predeterminados 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 PHP

Instala PHP, así como las extensiones PHP necesarias:

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-curl php7.2-mysql php7.2-json php7.2-xml php7.2-phar php7.2-pdo php7.2-gd

Para mostrar 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 y configuración de la base de datos.

Paso 2 – Instalar MySQL y crear una base de datos

Instala MySQL:

sudo apt install -y mysql-server

Comprueba la versión:

mysql --version
# mysql  Ver 14.14 Distrib 5.7.27, for Linux (x86_64) using  EditLine wrapper

Ejecuta el script mysql_secure_installation para mejorar la seguridad de tu instalación MySQL:

sudo mysql_secure_installation

Accede a MySQL como usuario root:

sudo mysql -u root -p
# Enter password:

Crea una nueva base de datos MySQL y un nuevo usuario y recuerda las credenciales:

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

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 el 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 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 el indicador --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. 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.

Tras obtener los certificados sal del usuario root y vuelve al usuario sudo normal:

exit

Paso 4 – 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.0 (Ubuntu)

Configura Nginx para X-Cart ejecutando:

sudo vim /etc/nginx/sites-available/xcart.conf

Y rellena el archivo con la siguiente configuración.

server {
  listen 80;
  listen [::]:80;
  root /var/www/xcart;
  index index.php index.html index.htm;
  server_name example.com;
  location @handler {
    index cart.php;
    rewrite ^/sitemap.xml(\?.+)?$ /cart.php?target=sitemap;
    rewrite ^/(.*)$ /cart.php?url=$1 last;
  }
  location / {
    try_files $uri $uri/ @handler;
  }
  location ~ \.php$ {
    try_files $uri @handler;
    fastcgi_split_path_info  ^(.+\.php)(/.+)$;
    fastcgi_index index.php;
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
}

Activa la nueva configuración de xcart.conf vinculando el archivo al directorio sites-enabled:

sudo ln -s /etc/nginx/sites-available/xcart.conf /etc/nginx/sites-enabled

Prueba la configuración:

sudo nginx -t

Recarga Nginx:

sudo systemctl reload nginx

Paso 5 – Instalar X-Cart

Navega hasta el directorio /var/www:

cd /var/www/

Descarga un paquete X-Cart 5 desde esta página:http://www.x-cart.com/download.html

Sube el paquete descargado a tu servidor.

Cambia la propiedad del directorio /var/www/xcart a www-data:

sudo chown -R www-data:www-data /var/www/xcart

Navega hasta example.com/install.php en tu navegador web y sigue las instrucciones para finalizar la instalación.

Paso 6 – Finalizar la instalación

Acepta el acuerdo de licencia y haz clic enSiguiente.

Asistente de instalación de X-Cart

Crear cuenta de administrador.

Crear cuenta Admin

El asistente de instalación comprobará si tu servidor cumple los requisitos del sistema para X-Cart 5

Comprueba los requisitos del sistema

Configura los ajustes de la base de datos:

Detalles de la conexión a la base de datos

Configurar Directorios + Paso 6. Todas las tareas de estos pasos están totalmente automatizadas, así que sólo tienes que esperar y dejar que X-Cart 5 haga el trabajo.

Actualizar .htaccess

Ahora que el proceso de instalación se ha completado , puedes utilizar los enlaces proporcionados para acceder a la interfaz de cliente y al área de administración de tu tienda.

 

Instalación completa

También te podría gustar...