Comment installer la plate-forme de commerce électronique X-Cart sur Debian 10

X-Cart est une plate-forme de commerce électronique open source extrêmement flexible avec des tonnes de fonctionnalités et d'intégrations. Le code source de X-Cart est hébergé sur Github. Ce guide décrit le processus d'installation de X-Cart 5 sur Debian 10 en utilisant Nginx comme serveur Web et MariaDB comme serveur de base de données.

Exigences

PHP version 7.2 ou supérieure
Extensions PHP :pdo , phar , mysql , mbstring , curl
MySQL version 5.7.7 ou supérieure ou équivalent MariaDB
Nginx

Étapes initiales

Vérifiez votre version Debian :

lsb_release -ds

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les packages de votre système d'exploitation (logiciels). Il s'agit d'une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les packages logiciels par défaut de votre système d'exploitation :

sudo apt update && sudo apt upgrade -y

Installez certains packages essentiels nécessaires à l'administration de base du système d'exploitation Debian :

sudo apt install -y curl wget vim git unzip socat bash-completion

Étape 1 - Installer PHP et les extensions PHP

Installez PHP, ainsi que les extensions PHP nécessaires :

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

Pour afficher PHP compilé en modules, vous pouvez exécuter :

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifiez la version de PHP :

php --version

# PHP 7.3.17-0debian0.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-0debian0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Le service PHP-FPM est automatiquement démarré et activé au redémarrage sur le système Debian 10, il n'est donc pas nécessaire de le démarrer et de l'activer manuellement. Nous pouvons passer à l'étape suivante, qui est l'installation et la configuration de la base de données.

Étape 2 :Installez MariaDB et créez une base de données

Installer MySQL :

sudo apt install -y mariadb-server

Vérifiez la version :

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

Exécutez le mysql_secure_installation script pour améliorer la sécurité de votre installation MariaDB :

sudo mysql_secure_installation

Connectez-vous à MariaDB en tant qu'utilisateur racine :

sudo mysql -u root -p
# Enter password:

Créez une nouvelle base de données et un utilisateur MariaDB et mémorisez les identifiants :

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

Étape 3 :Installez le client acme.sh et obtenez le certificat Let's Encrypt (facultatif)

Sécuriser votre site Web avec HTTPS n'est pas nécessaire, mais c'est une bonne pratique pour sécuriser le trafic de votre site. Afin d'obtenir un certificat TLS de Let's Encrypt, nous utiliserons le client acme.sh. Acme.sh est un logiciel shell UNIX pur permettant d'obtenir des certificats TLS de Let's Encrypt sans aucune dépendance.

Téléchargez et installez 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 ~

Vérifiez la version d'acme.sh :

acme.sh --version
# v2.8.6

Obtenir RSA et ECC/ECDSA certificats pour votre domaine/nom d'hôte :

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Si vous voulez de faux certificats pour les tests, vous pouvez ajouter le --staging indicateur aux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, vos certificats et les clés sera dans :

Pour RSA :/home/username/example.com répertoire.
Pour ECC/ECDSA :/home/username/example.com_ecc répertoire.

Pour répertorier vos certificats émis, vous pouvez exécuter :

acme.sh --list

Créez un répertoire pour stocker vos certificats. Nous utiliserons le /etc/letsencrypt répertoire.

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

Installez/copiez les certificats dans le répertoire /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 systemctl reload nginx.service"

Tous les certificats seront automatiquement renouvelés tous les 60 jours.

Après avoir obtenu les certificats, quittez l'utilisateur root et revenez à l'utilisateur sudo normal :

exit

Étape 4 - Installer et configurer Nginx

Installez Nginx :

sudo apt install -y nginx

Vérifiez la version de Nginx :

sudo nginx -v
# nginx version: nginx/1.14.0

Configurez Nginx pour X-Cart en exécutant :

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

Et remplissez le fichier avec la configuration ci-dessous.

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.3-fpm.sock;
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
}

Activez le nouveau xcart.conf configuration en liant le fichier au sites-enabled répertoire :

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

Testez la configuration :

sudo nginx -t

Recharger Nginx :

sudo systemctl reload nginx

Étape 5 - Installer X-Cart

Accédez au /var/www répertoire :

cd /var/www/

Téléchargez la version la plus récente de X-Cart sur https://www.x-cart.com/download.html et décompressez-la à la racine de votre document :

Après le téléchargement, changez le propriétaire du /var/www/xcart répertoire vers www-data:

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

Accédez à example.com/install.php dans votre navigateur Web et suivez les instructions pour terminer l'installation.

Étape 6 - Terminer la configuration

Acceptez le contrat de licence et cliquez sur Suivant .

Créez un compte administrateur.

L'assistant d'installation vérifiera si votre serveur répond à la configuration système requise pour X-Cart 5

Configurer les paramètres de la base de données :

Configuration des répertoires + Étape 6. Création du cache. Toutes les tâches de ces étapes sont entièrement automatisées, il vous suffit donc d'attendre et de laisser X-Cart 5 faire le travail

Maintenant, le processus d'installation est terminé. Vous pouvez utiliser les liens fournis pour accéder à l'interface client et à la zone d'administration de votre boutique.