Comment installer Shopware avec NGINX et Let’s Encrypt sur Fedora 30

Shopware est la prochaine génération de logiciels de commerce électronique open source. Basé sur des technologies d’avant-garde comme Symfony3, Doctrine2etZend Framework Shopwareest la plateforme parfaite pour ton prochain projet de commerce électronique. Ce tutorielte guidera dans l’installation de Shopware Community Edition (CE) sur le système Fedora 30 en utilisant NGINX comme serveur Web.

Exigences

Assure-toi que ton système répond aux exigences minimales suivantes:

  • Système d’exploitation basé sur Linux avec un serveurWeb NGINX ou Apache 2.x (avec mod_rewrite) installé.
  • PHP 5.6.4 ou supérieur avec les extensions ctype, gd, curl, dom, hash, iconv, zip, json, mbstring, openssl, session, simplexml, xml, zlib, fileinfo et pdo/mysql. PHP 7.1 ou supérieur est fortement recommandé.
  • MySQL 5.5.0 ou supérieur.
  • Possibilité de configurer des tâches cron.
  • Minimum 4 Go d’espace disque disponible.
  • IonCube Loader version 5.0.0 ou supérieure(facultatif).

REMARQUE : Shopware 5 est actuellement compatible avecPHP 7.2.x.

Conditions préalables

  • Un système d’exploitation exécutant Fedora 29.
  • Un utilisateur non-root avec des privilèges sudo.

J’utiliserai le nom de domaine exemple.com dans ce tutoriel. Remplace le mot example.com par ton propre nom de domaine chaque fois qu’il apparaît dans les commandes et les fichiers de configuration ci-dessous (en particulier dans le fichier de configuration de nginx et les commandes Let’s encrypt).

Étapes initiales

Vérifie ta version de Fedora :

cat /etc/fedora-release
# Fedora release 29 (Twenty Nine)

Configure le fuseau horaire :

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Mets à jour les paquets de ton système d’exploitation (logiciels). C’est une première étape importante car elle permet de s’assurer que tu disposes des dernières mises à jour et des derniers correctifs de sécurité pour les paquets logiciels par défaut de ton système d’exploitation :

sudo dnf upgrade -y

Installe certains paquets essentiels qui sont nécessaires à l’administration de base du système d’exploitation Fedora :

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

Étape 1 – Installer PHP et les extensions PHP

Installe PHP, ainsi que les extensions PHP nécessaires pour Shopware :

sudo dnf install -y php php-cli php-fpm php-common php-mysqlnd php-curl php-json php-zip php-gd php-xml php-mbstring php-opcache

Pour afficher PHP compilé en modules, tu peux exécuter :

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifie la version 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

Démarre et active le service PHP-FPM :

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

Nous pouvons passer à l’étape suivante, qui est l’installation de IonCube Loader.

Étape 2 – Installer IonCube Loader(facultatif)

Cette étape est facultative car Shopware fonctionne sans IonCube maintenant, mais il se peut qu’il y ait encore des extensions ou des thèmes qui utilisent IonCube, donc cela ne fait pas de mal de l’installer. Télécharge le chargeur IonCube :

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

Extrais le chargeur :

tar xfz ioncube_loaders_lin_*.gz

Trouve le répertoire des extensions PHP sur le système en exécutant la commande ci-dessous :

php -i | grep extension_dir
# extension_dir => /usr/lib64/php/modules => /usr/lib64/php/modules

Copie le chargeur ionCube dans le répertoire des extensions PHP :

sudo cp /tmp/ioncube/ioncube_loader_lin_7.2.so /usr/lib64/php/modules

Inclus le chargeur via la configuration PHP :

sudo vim /etc/php.ini

Ajoute ensuite une ligne dans le fichier pour inclure le chargeur ionCube. Elle peut se trouver n’importe où dans le fichier, en dessous de la ligne[PHP]:

zend_extension = /usr/lib64/php/modules/ioncube_loader_lin_7.2.so

Sauvegarde le fichier et redémarre PHP-FPM :

sudo systemctl restart php-fpm.service

Étape 3 – Installe MariaDB et crée une base de données pour Shopware

Installe le serveur de base de données MariaDB :

sudo dnf install -y mariadb-server

Vérifie la version de MariaDB :

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

Démarre et active le service MariaDB :

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Exécutemysql_secure installationscript pour améliorer la sécurité de MariaDB et définir le mot de passe pour MariaDBroot utilisateur :

sudo mysql_secure_installation

Réponds à chacune des questions :

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

Connecte-toi au shell MariaDB en tant qu'utilisateur root :

sudo mysql -u root -p
# Enter password

Crée une base de données MariaDB vide et un utilisateur pour Shopware et mémorise les informations d'identification :

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

Sors de MariaDB:

mysql> exit

Remplacedbname,usernameetpasswordpar tes propres noms.

Étape 4 - Installe le client Acme.sh et obtiens le certificat Let's Encrypt (facultatif)

Il n'est pas nécessaire de sécuriser ton site Web avec HTTPS, mais c'est une bonne pratique pour sécuriser le trafic de ton 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 pour obtenir des certificats TLS de Let's Encrypt avec zéro dépendance.

Télécharge et installe 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érifie la version d'acme.sh :

acme.sh --version
# v2.8.1

Obtiens descertificats RSAet ECC/ECDSA pourton 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 tu veux des faux certificats pour les tester, tu peux ajouter le drapeau--stagingaux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tescertificats et tes clés seront dans:

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

Pour répertorier tes certs émis, tu peux exécuter :

acme.sh --list

Crée un répertoire pour stocker tes certs. Nous utiliserons un répertoire/etc/letsencrypt.

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

Installe/copie les certificats dans/etc/letsencryptrépertoire.

# 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, quitte l'utilisateur root et retourne à l'utilisateur normal sudo :

exit

Étape 5 - Installer et configurer NGINX

Installe le serveur Web NGINX :

sudo dnf install -y nginx

Vérifie la version de NGINX :

nginx -v
# nginx version: nginx/1.14.2

Démarre et active le service NGINX :

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

ConfigurerNGINXpourShopware. Exécutersudo vim /etc/nginx/conf.d/shopware.confet ajoute la configuration suivante :

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 fastcgi.conf;
        fastcgi_pass unix:/run/php-fpm/www.sock;
    }
}

VérifierNGINXpour vérifier qu'il n'y a pas d'erreurs de syntaxe dans la configuration :

sudo nginx -t

RechargerNGINXservice :

sudo systemctl reload nginx.service

Étape 6 - Installer Shopware

Crée un répertoire racine de documents pour Shopware :

sudo mkdir -p /var/www/shopware

Change la propriété du répertoire/var/www/shopwarepour {votre_utilisateur}. Remplace {votre_utilisateur} par le nom d'utilisateur de l'utilisateur auquel tu es actuellement connecté :

sudo chown -R {your_user}:{your_user} /var/www/shopware

Navigue dans le répertoire racine du document :

cd /var/www/shopware

Télécharge et décompresse la dernièreversion de Shopwarevia 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

REMARQUE :Mets à jour l'URL de téléchargement s'il existe une version plus récente.

Change la propriété du répertoire/var/www/shopwareennginx.

sudo chown -R nginx:nginx /var/www/shopware

Exécutesudo vim /etc/php-fpm.d/www.confet configurel'utilisateur et le groupe ànginx. Initialement, ils seront définis surapache:

sudo vim /etc/php-fpm.d/www.conf
user = nginx
group = nginx

Créer le répertoire/var/lib/php/session/et change la propriété ennginx.

sudo mkdir -p /var/lib/php/session && sudo chown -R nginx:nginx /var/lib/php/session

Augmentememory_limit = 256Metupload_max_filesize = 6M, et configureallow_url_fopen = Onsi ce n'est pas déjà fait dans lefichier/etc/php/7.2/fpm/php.ini.

sudo vim /etc/php.ini

Après avoir effectué les modifications dans le fichier/etc/php.ini, rechargerphp-fpm.service:

sudo systemctl reload php-fpm.service

Ouvre ton domaine/IP dans le navigateur Web et suis l'assistant d'installation. Le backend de Shopware se trouve à l'adresse/backend; exemple :http://example.com/backend.

Étape 7 - Termine l'installation de Shopware

Commence par sélectionner la langue et clique sur Suivant :

Assistant de configuration de Shopware

Ensuite, assure-toi que tu réponds à toutes les exigences de Shopware :

Les exigences du système sont respectées

Accepte les CGU de Shopware et clique sur Suivant :

Accept license

Saisis les informations d'identification de la base de données et clique sur Suivant :

Paramètres de la base de données Shopware

Lance l'installation pour créer les tables de la base de données :

Installation des tables de la base de données

Après cela, tu verras un message indiquant que l'importation de la base de données a réussi :

Initialisation de la base de données réussie

Choisis une licence et clique sur Suivant :

Choisis une licence

Remplis quelques paramètres de base pour terminer l'installation et clique sur Suivant :

Paramètres de base

L'installation est terminée.

L'installation est terminée

Pour accéder à la zone d'administration, ajoute /backend à ton URL.

Connexion au backend de Shopware

Tu as installé Shopware avec succès. Profite de ta nouvelle boutique en ligne !

Vous aimerez aussi...