Comment installer Magento 2 avec Nginx et SSL Let's Encrypt sur Ubuntu 20.04 LTS

Magento est un logiciel de commerce électronique open source largement utilisé et un système de gestion de contenu pour les sites Web de commerce électronique basé sur le framework PHP Zend. Il utilise MySQL ou MariaDB comme backend de base de données. Le développement de Magento a commencé en 2008 par Varien.

Dans ce tutoriel, nous allons vous montrer étape par étape comment installer Magento 2 sur la dernière version d’Ubuntu 20.04. Nous installerons Magento sous la pile LEMP, le serveur web Nginx, PHP-FPM 7.3 et le serveur MariaDB.

Exigences

Pour ce tutoriel, nous allons installer Magento 2 sur le système Ubuntu 20.04 avec 2 Go de RAM, 50 Go d’espace disque libre et 2 CPU.

Que allons-nous faire ?

Installer le serveur web Nginx
Installer et configurer PHP-FPM 7.3
Installer et configurer le serveur MySQL
Installer PHP Composer
Télécharger et installer Magento
Générer SSL Letsencrypt
Configurer l’hôte virtuel Nginx pour Magento
Post-installation de Magento

Étape 1 - Installer le serveur web Nginx

Tout d’abord, nous allons installer le serveur web Nginx sur le système Ubuntu 20.04.

Installez Nginx en utilisant la commande apt ci-dessous.

sudo apt install nginx

Une fois toute l’installation terminée, démarrez le service Nginx et ajoutez-le au démarrage du système.

systemctl start nginx  
systemctl enable nginx

Après cela, vérifiez l’état du service Nginx en utilisant la commande suivante.

systemctl status nginx

Le serveur web Nginx est opérationnel sur le serveur Ubuntu 20.04.

Installer Nginx

Ensuite, nous allons ouvrir les ports HTTP et HTTPS sur notre système Ubuntu.

Exécutez la commande ufw ci-dessous.

for svc in ssh http https  
do  
ufw allow $svc  
done

En conséquence, les services SSH, HTTP et HTTPS ont été ajoutés à la règle de pare-feu ufw.

Maintenant, activez le pare-feu ufw en utilisant la commande suivante.

ufw enable

Tapez ‘y’ et appuyez sur Entrée, et vous avez activé le pare-feu ufw.

Étape 2 - Installer et configurer PHP-FPM 7.3

Après avoir installé le serveur web Nginx, nous allons installer PHP-FPM sur notre serveur Ubuntu 20.04.

Par défaut, Ubuntu 20.04 est livré avec la dernière version de PHP/PHP-FPM 7.4. Mais pour l’instant, Magento ne fonctionne qu’avec PHP/PHP-FPM 7.3. Et à cette étape, nous allons installer PHP-FPM 7.3 à partir du dépôt PPA.

Avant d’aller plus loin, installez le paquet ‘software-properties-common’ et ajoutez le dépôt PPA pour PHP 7.3 en utilisant la commande suivante.

sudo apt install software-properties-common  
sudo add-apt-repository ppa:ondrej/php

La commande ‘add-apt-repository’ mettra automatiquement à jour tous les dépôts sur le système.

Maintenant, installez les paquets PHP-FPM 7.3 à partir du dépôt PPA en utilisant la commande apt ci-dessous.

sudo apt install php7.3-fpm php7.3-common php7.3-curl php7.3-cli php7.3-mysql php7.3-gd php7.3-xml php7.3-json php7.3-intl php-pear php7.3-dev php7.3-common php7.3-mbstring php7.3-zip php7.3-soap php7.3-bcmath php7.3-opcache -y

Et l’installation de PHP-FPM 7.3 est terminée.

Après cela, allez dans le répertoire ‘/etc/php/7.3’ et éditez la configuration ‘php.ini’ pour PHP-FPM.

cd /etc/php/7.3/  
vim fpm/php.ini

Décommentez et changez la configuration comme ci-dessous.

date.timezone = Asia/Singapore  
memory_limit = 1G  
max_execution_time = 1800  
zlib.output_compression = On  
cgi.fix_pathinfo = 0  
  
opcache.enable=1   
opcache.save_comments = 1

Enregistrez et fermez.

Ensuite, démarrez le service PHP-FPM et ajoutez-le au démarrage du système.

systemctl start php7.3-fpm  
systemctl enable php7.3-fpm

Installer et configurer PHP-FPM 7.3

Le service PHP-FPM est opérationnel, vérifiez-le en utilisant la commande ci-dessous.

ss -xa | grep php  
systemctl status php7.3-fpm

En conséquence, le PHP-FPM est opérationnel sur le serveur Ubuntu 20.04, il fonctionne sous le fichier sock ‘/run/php/php7.3-fpm.sock’.

Vérifier le service PHP-FPM

Étape 3 - Installer et configurer le serveur MariaDB

À cette étape, nous allons installer le serveur de base de données MariaDB, configurer le mot de passe root par défaut pour MariaDB, et créer une nouvelle base de données et un utilisateur pour Magento.

Installez les paquets du serveur MariaDB sur Ubuntu 20.04 en utilisant la commande apt ci-dessous.

sudo apt install mariadb-server

Une fois toute l’installation terminée, démarrez le service MariaDB et ajoutez-le au démarrage du système.

systemctl start mariadb  
systemctl enable mariadb

Le service MariaDB est opérationnel.

Ensuite, nous allons configurer le mot de passe root de MariaDB en utilisant l’utilitaire ‘mysql_secure_installation’.

Exécutez la commande ‘mysql_secure_installation’ ci-dessous.

mysql_secure_installation

Tapez votre mot de passe fort pour l’utilisateur root de MariaDB et tapez ‘Y’ pour toutes les configurations.

Set a root password? [Y/n] Y  
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

En conséquence, le mot de passe root de MariaDB a été configuré.

Configurer le mot de passe root de MariaDB

Ensuite, nous allons créer une nouvelle base de données et un utilisateur pour l’installation de Magento.

Connectez-vous à l’interface de commande MariaDB/MySQL en utilisant la commande mysql ci-dessous.

mysql -u root -p

Maintenant, créez une nouvelle base de données pour notre installation de Magento. Créez la base de données ‘magentodb’ et l’utilisateur ‘magentouser’ avec le mot de passe ‘magentodbpass’.

Exécutez les requêtes MySQL ci-dessous.

create database magentodb;  
create user magentouser@'localhost' identified by 'magentopassdb';  
grant all privileges on magentodb.* to magentouser@'localhost';  
flush privileges;

Maintenant, tapez ‘exit’ pour vous déconnecter de l’interface de commande MySQL.

Créer une base de données pour Magento

En conséquence, la nouvelle base de données et l’utilisateur pour l’installation de Magento ont été créés.

Étape 4 - Installer Composer

Composer est un gestionnaire de dépendances pour PHP. C’est un gestionnaire de paquets au niveau de l’application pour PHP qui vous permet de télécharger des dépendances et des bibliothèques PHP supplémentaires pour votre projet PHP.

À cette étape, nous allons installer PHP Composer à partir du dépôt Ubuntu.

Installez Composer en utilisant la commande apt ci-dessous.

sudo apt install composer -y

Une fois l’installation terminée, vérifiez la version de composer ci-dessous.

composer --version

Voici la réponse que vous obtiendrez.

Composer 1.10.1 2020-03-13 20:34:27

Comme vous pouvez le voir, Composer 1.10 a été installé sur le serveur Ubuntu 20.04.

Étape 5 - Télécharger et installer Magento 2

À cette étape, nous allons télécharger et installer Magento 2, ainsi que tous les paquets PHP nécessaires en utilisant Composer.

Tout d’abord, allez dans le répertoire ‘/var/www/‘ et téléchargez le code source de Magento 2.3.5 CE (Community Edition) en utilisant la commande wget ci-dessous.

cd /var/www/  
wget -q https://github.com/magento/magento2/archive/2.3.5.tar.gz

Une fois tout est terminé, extrayez le code source de Magento et renommez le répertoire extrait en répertoire ‘magento2’.

tar -xf 2.3.5.tar.gz  
mv magento2-*/ magento2/

Ensuite, allez dans le répertoire d’installation de Magento ‘/var/www/magento2’ et installez toutes les dépendances de paquets PHP pour Magento en utilisant la commande Composer ci-dessous.

cd /var/www/magento2/  
composer install

Télécharger et installer Magento 2

Une fois toute l’installation terminée, corrigez la propriété du répertoire d’installation de Magento 2 à l’utilisateur ‘www-data’.

chown -R www-data:www-data /var/www/magento2

En conséquence, l’installation de Magento 2 et de toutes les dépendances de paquets a été complétée.

Étape 6 - Générer SSL Letsencrypt

Pour ce tutoriel, nous allons sécuriser l’installation de Magento 2 en utilisant SSL Letsencrypt. Et à cette étape, nous allons générer le SSL Letsencrypt en utilisant la commande certbot. Assurez-vous également que votre nom de domaine est résolu à l’adresse IP du serveur.

Installez l’outil certbot en utilisant la commande apt ci-dessous.

sudo apt install certbot

Une fois l’installation terminée, arrêtez le service Nginx.

systemctl stop nginx  
certbot certonly --standalone --agree-tos --no-eff-email --email [email protected] -d magento.hakase-labs.io

Une fois tout est terminé, vous obtiendrez vos certificats SSL dans le répertoire ‘/etc/letsencrypt/live/magento.your-domain.com’.

En conséquence, le SSL Letsencrypt pour l’installation de Magento 2 a été généré.

Étape 7 - Configurer l’hôte virtuel Nginx pour Magento 2

À cette étape, nous allons ajouter une nouvelle configuration d’hôte virtuel Nginx pour Magento 2.

Allez dans le répertoire ‘/etc/nginx/sites-available/‘ et créez une nouvelle configuration ‘magento’ en utilisant l’éditeur vim.

cd /etc/nginx/sites-available/  
vim magento

Collez la configuration suivante dedans.

upstream fastcgi_backend {  
        server  unix:/run/php/php7.3-fpm.sock;  
}  
  
server {  
    listen 80;  
    listen [::]:80;  
    server_name magento.hakase-labs.io;  
    return 301 https://$server_name$request_uri;  
}  
  
server {  
        listen 443 ssl http2;  
        server_name magento.hakase-labs.io;  
  
        ssl_certificate /etc/letsencrypt/live/magento.hakase-labs.io/fullchain.pem;  
        ssl_certificate_key /etc/letsencrypt/live/magento.hakase-labs.io/privkey.pem;  
  
        set $MAGE_ROOT /var/www/magento2;  
        set $MAGE_MODE developer;  
        include /var/www/magento2/nginx.conf.sample;  
}

Enregistrez et fermez.

Ensuite, activez l’hôte virtuel Nginx de Magento et testez la configuration nginx, et assurez-vous qu’il n’y a pas d’erreur.

ln -s /etc/nginx/sites-available/magento /etc/nginx/sites-enabled/  
nginx -t

Maintenant, redémarrez le service Nginx en utilisant la commande suivante.

systemctl restart nginx

En conséquence, la configuration de l’hôte virtuel Nginx pour Magento 2 a été créée et activée.

Configurer l'hôte virtuel Nginx pour Magento

Étape 8 - Post-installation de Magento

Ouvrez votre navigateur web et tapez le nom de domaine de votre installation Magento dans la barre d’adresse.

https://magento.hakase-labs.io/

Maintenant, vous serez redirigé vers une connexion sécurisée HTTPS et vous obtiendrez la page d’accueil de Magento et les conditions de service.

Installer Magento 2

Cliquez sur le bouton ‘Accepter et configurer Magento‘ pour continuer.

Sur la page ‘Vérification de la préparation’, assurez-vous que toutes les exigences sont vertes et cliquez sur le bouton ‘Suivant‘.

Vérification des exigences système

Tapez les détails de la base de données MariaDB et de l’utilisateur que nous avons créés ci-dessus et cliquez sur ‘Suivant‘.

Configurer la base de données

Pour la ‘Configuration Web’, changez tous les protocoles HTTP en HTTPS, et assurez-vous de changer l’ ‘Adresse Admin Magento’.

Configurer HTTPS Magento

Maintenant, cliquez sur ‘Options avancées’ et cochez toutes les options HTTPS, puis décochez l’option ‘Réécritures Apache’ et cliquez à nouveau sur le bouton ‘Suivant‘.

Ensuite, sur la configuration ‘Personnalisez votre magasin’ de Magento, laissez-le par défaut et cliquez sur le bouton ‘Suivant‘.

Personnalisation du magasin Magento

Maintenant, tapez les détails de l’utilisateur admin, l’email et le mot de passe. Ensuite, cliquez sur le bouton Suivant.

Configurer l'utilisateur Magento

Cliquez sur le bouton ‘Installer maintenant’ pour installer votre magasin Magento 2.

Installer Magento

Maintenant, assurez-vous que toute l’installation n’a pas d’erreur.

Installer Magento

Une fois toute l’installation terminée, vous obtiendrez la page ‘Succès‘ comme ci-dessous.

L'installation de Magento est terminée

Cliquez sur ‘Lancer Magento Admin‘ pour vous connecter à votre tableau de bord Admin Magento.

Connexion Admin Magento

Maintenant, tapez votre utilisateur Admin Magento et votre mot de passe, puis cliquez sur ‘Se connecter‘ et vous obtiendrez le tableau de bord Admin Magento comme ci-dessous.

Tableau de bord Admin Magento

Pour la page d’index par défaut de Magento, ouvrez un nouvel onglet et tapez votre nom de domaine dans la barre d’adresse.

Voici la page d’index par défaut de Magento.

Index Magento

En conséquence, l’installation de Magento 2 a été complétée.

Ensuite, retournez à votre shell serveur et nous allons configurer le Cron de Magento et retirer les permissions d’écriture de certains répertoires d’installation de Magento.

Pour configurer le cron de Magento, exécutez la commande ci-dessous.

cd /var/www/magento2  
sudo -u www-data php bin/magento cron:install --force

Le cron de Magento s’exécutera sous l’utilisateur ‘www-data’, vérifiez-le en utilisant la commande suivante.

crontab -u www-data -l

En conséquence, le Cron de Magento a été ajouté au système.

Configurer le Cron de Magento et retirer les permissions d'écriture

Ensuite, nous devons retirer la permission d’écriture du répertoire ‘/var/www/magento2/app/etc’.

Exécutez la commande chmod ci-dessous.

chmod u-w /var/www/magento2/app/etc

Et enfin, l’installation de Magento 2 avec le serveur web Nginx, le serveur MariaDB, PHP-FPM 7.3 sur le dernier Ubuntu 20.04 a été complétée avec succès.

Référence

https://devdocs.magento.com/