Comment installer Shopware avec NGINX et Let’s Encrypt sur FreeBSD 12

Shopware est la prochaine génération de logiciels de commerce électronique open source. Basé sur des technologies d’avant-garde comme Symfony 3, Doctrine2et Zend FrameworkShopware est la plateforme parfaite pour ton prochain projet de commerce électronique.Ce tutoriel te guidera dans l’installation de Shopware Community Edition (CE) sur le système FreeBSD 12 en utilisant NGINX comme serveur Web.

Exigences

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

  • Système d’exploitation basé sur Linux avec un serveur Web NGINX ou Apache 2.x (avecmod_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 avec PHP 7.2.x.

Conditions préalables

  • Un système d’exploitation exécutant FreeBSD 12.
  • 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 FreeBSD :

uname -ro
# FreeBSD 12.0-RELEASE

Configure le fuseau horaire :

tzsetup

Mets à jour les paquets (logiciels) de ton système d’exploitation. 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 :

freebsd-update fetch install
pkg update && pkg upgrade -y

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

pkg install -y sudo vim unzip wget bash socat

Étape 1 – Installer PHP et les extensions PHP

Installe PHP, ainsi que les extensions PHP nécessaires pour 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

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 sysrc php_fpm_enable=yes
sudo service php-fpm start

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_fre_11_x86-64.tar.gz

Extrais le chargeur :

tar xfz ioncube_loaders_fre_*.tar.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/local/lib/php/20170718 => /usr/local/lib/php/20170718

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

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

Inclus le chargeur via la configuration PHP :

sudo vim /usr/local/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/local/lib/php/20170718/ioncube_loader_fre_7.2.so

Sauvegarde le fichier et redémarre PHP-FPM :

sudo service php-fpm restart

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

Installe le serveur de base de données MariaDB :

sudo pkg install -y mariadb102-client mariadb102-server

Vérifie la version deMariaDB:

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 sysrc mysql_enable="yes"
sudo service mysql-server start

Exécute le scriptmysql_secure installation pour améliorer la sécurité deMariaDB et définir le mot de passe de l’utilisateurMariaDB root :

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 shellMariaDB en tant qu'utilisateur root :

sudo mysql -u root -p
# Enter password

Crée une base de donnéesMariaDB 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 deMariaDB:

mysql> exit

Remplace dbname, username et password par 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 sans aucune dépendance.

Télécharge et installe acme.sh :

sudo pkg install -y acme.sh

Vérifie la version d'acme.sh :

acme.sh --version
# v2.8.2

Obtiens des certificats RSA et ECC/ECDSA pour ton 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 de 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 tesclé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 service nginx reload"

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 pkg 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 sysrc nginx_enable=yes
sudo service nginx start

Configure Nginx pour Shopware en exécutant :

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

Et remplissez le fichier avec la configuration suivante :

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

Exécute sudo vim /usr/local/etc/nginx/nginx.conf et ajoute la ligne ci-dessous au bloc http {} pour inclure la configuration Shopware.

include shopware.conf;

Vérifie que la configuration Nginx ne contient pas d'erreurs de syntaxe :

sudo nginx -t

Recharge le service Nginx :

sudo service nginx reload

Étape 6 - Installer Shopware

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

sudo mkdir -p /usr/local/www/shopware

Navigue vers le répertoire racine du document :

cd /usr/local/www/shopware

Télécharge et décompresse 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

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

Fournis la propriété appropriée :

sudo chown -R www:www /usr/local/www/shopware

Augmente memory_limit = 256M et upload_max_filesize = 6M, et configure allow_url_fopen = On s'il n'est pas déjà configuré dans le fichier /usr/local/etc/php.ini:

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

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

sudo service php-fpm reload

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 d'installation de Shopware

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

Configuration requise pour Shopware

Accepte les CGU de Shopware et clique sur Suivant :

Conditions d'utilisation de ShopWare

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

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

Créer des tables de base de données

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

Installation réussie

Choisis une licence et clique sur Suivant :

Licences

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

Configuration de base du magasin

L'installation est terminée.

Installation terminée

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

Connexion Shopware

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

Vous aimerez aussi...