Comment installer Prestashop avec Apache et SSL Let's Encrypt gratuit sur Debian 12

Prestashop est une solution de commerce électronique open-source gratuite écrite en PHP. Elle vous permet d’héberger et de créer vous-même des boutiques en ligne et de développer votre entreprise en ligne. Prestashop est une solution de commerce électronique entièrement personnalisable et riche en fonctionnalités qui vous permet de créer des sites web de commerce électronique complets. Prestashop est maintenant utilisé par plus de 250 000 boutiques en ligne dans le monde et est disponible en 65 langues.

Dans ce tutoriel, je vais vous guider étape par étape à travers l’installation de PrestaShop sur un serveur Debian 12. Vous installerez PrestaShop avec la pile LAMP (Apache2, MariaDB et PHP) puis sécuriserez votre installation PrestaShop avec des certificats SL/TLS via Letsencrypt.

Prérequis

Avant de commencer, veuillez avoir les éléments suivants prêts :

Un serveur Debian 12.
Un utilisateur non-root avec des privilèges d’administrateur.
Un nom de domaine pointé vers l’adresse IP du serveur.

Installation des dépendances

PrestaShop est une plateforme open-source pour créer une boutique en ligne écrite en PHP avec MariaDB/MySQL comme base de données. Dans l’étape suivante, vous installerez les dépendances pour PrestaShop, qui incluent les paquets de la pile LAMP (Apache2, MariaDB et PHP) avec quelques extensions PHP supplémentaires. Vous installerez spécifiquement PHP 8.1 via un dépôt tiers car l’actuel PrestaShop ne prend pas encore en charge PHP 8.2.

Tout d’abord, exécutez la commande suivante pour ajouter un dépôt PHP tiers et une clé GPG à votre système Debian.

sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg  
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

Mettez à jour et rafraîchissez votre index de paquets Debian en exécutant la commande apt suivante.

sudo apt update

Une fois le dépôt mis à jour, installez les dépendances pour PrestaShop en utilisant la commande suivante. Cela installera les paquets LAMP Stack (Apache2, MariaDB, PHP 8.1), Certbot, plugin Certbot Apache, et extensions PHP supplémentaires requises par PrestaShop.

sudo apt install apache2 mariadb-server certbot python3-certbot-apache php8.1 php8.1-curl php8.1-xmlrpc php8.1-soap php8.1-intl php8.1-zip php8.1-cli php8.1-mysql php8.1-common php8.1-opcache php8.1-memcached php8.1-bcmath php8.1-gd php8.1-mbstring php8.1-xml php8.1-gmp php8.1-imagick unzip

Tapez y pour continuer avec l’installation.

install deps

Après l’installation des dépendances, vérifiez chaque dépendance en utilisant la commande suivante.

Vérifiez le service apache2 pour vous assurer que le service fonctionne en exécutant la commande systemctl ci-dessous.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Le résultat suivant sera affiché, ce qui confirme que le service apache2 fonctionne et est activé.

check apache2

Maintenant, vérifiez le service mariadb en utilisant la commande suivante.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

La sortie affichée ci-dessous confirme que le service mariadb fonctionne et est activé.

check mariadb

Enfin, exécutez la commande suivante pour vérifier votre version PHP et lister les extensions activées.

php -v  
php -m

Vous devriez voir que PHP 8.1 est installé sur votre machine Debian avec la liste des extensions activées.

check php

Configuration du serveur MariaDB

Maintenant que vous avez installé les dépendances pour PrestaShop, l’étape suivante consiste à sécuriser votre installation de serveur MariaDB via l’utilitaire mariadb-secure-installation. Ensuite, vous devrez créer une nouvelle base de données et un utilisateur pour PrestaShop.

Exécutez la commande mariadb-secure-installation ci-dessous pour sécuriser votre installation de serveur MariaDB.

sudo mariadb-secure-installation

Entrez Y pour confirmer et appliquer la nouvelle configuration, ou n pour Non, et la rejeter. Voici les configurations de serveur MariaDB pour lesquelles vous serez interrogé :

Passer à l’authentification unix_socket ? Entrez n et appuyez sur ENTRÉE. L’utilisateur root par défaut de MariaDB est déjà protégé. En option, vous pouvez également l’activer en tapant y pour oui.
Changer le mot de passe root ? Entrez y pour confirmer et définir votre nouveau mot de passe root MariaDB.
Supprimer l’utilisateur anonyme ? Entrez y pour confirmer.
Interdire la connexion root à distance ? Entrez y pour confirmer. Seule la connexion locale sera autorisée si vous utilisez l’utilisateur root de MariaDB.
Supprimer la base de données de test et l’accès à celle-ci ? Entrez y pour confirmer et supprimer la base de données par défaut ‘test’.
Enfin, entrez y à nouveau pour recharger tous les privilèges des tables sur votre serveur MariaDB et appliquer les nouvelles modifications.

Ensuite, exécutez la commande du client mariadb ci-dessous pour vous connecter au serveur MariaDB. Entrez votre mot de passe root MariaDB lorsque vous y êtes invité.

sudo mariadb -u root -p

Une fois connecté, exécutez les requêtes suivantes pour créer une nouvelle base de données prestashopdb, un utilisateur prestashop, avec le mot de passe password. La nouvelle base de données et l’utilisateur MariaDB ici seront l’utilisateur pour l’installation de PrestaShop.

CREATE DATABASE prestashopdb;  
GRANT ALL PRIVILEGES ON prestashopdb.* TO 'prestashop'@'localhost' IDENTIFIED BY 'password';  
FLUSH PRIVILEGES;

Ensuite, exécutez la requête suivante pour vérifier l’utilisateur MariaDB prestashop.

SHOW GRANTS FOR 'prestashop'@'localhost';

La sortie affichée ci-dessous révèle que l’utilisateur MariaDB prestashop est autorisé à accéder à la base de données prestashopdb.

check user privileges

Enfin, tapez quit pour quitter le serveur MariaDB.

Configuration de PHP

Après avoir configuré le serveur MariaDB, vous allez configurer votre installation PHP en modifiant le fichier php.ini. Ensuite, vous vérifierez également votre environnement pour vous assurer que tout ce qui concerne la configuration PHP est conforme aux exigences de PrestaShop.

Ouvrez la configuration PHP par défaut /etc/php/8.1/apache2/php.ini en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/php/8.1/apache2/php.ini

Changez la configuration ci-dessous et assurez-vous d’ajuster les paramètres date.timezone et memory_limit en fonction de votre environnement serveur.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande systemctl suivante pour redémarrer le service apache2 et appliquer les modifications.

sudo systemctl restart apache2

Maintenant que vous avez configuré PHP, vous allez vérifier que votre environnement serveur est prêt pour l’installation de PrestaShop. Cela peut être fait en utilisant le vérificateur d’environnement fourni par PrestaShop.

Déplacez-vous dans le répertoire /var/www/html et téléchargez le script de vérification de l’environnement via la commande wget ci-dessous. Vous verrez le fichier v1.1.tar.gz dans votre répertoire de travail actuel.

cd /var/www/html  
wget https://github.com/PrestaShop/php-ps-info/archive/refs/tags/v1.1.tar.gz

Extrayez le fichier v1.1.tar.gz et renommez le répertoire extrait en check-ps.

tar -xf v1.1.tar.gz  
mv php-ps-info-1.1 check-ps

Enfin, ouvrez votre navigateur web et visitez l’adresse IP du serveur suivie du chemin check-ps pour accéder au script de vérification de l’environnement PrestaShop, tel que http://192.168.10.15/check-ps/phppsinfo.php.

Entrez le nom d’utilisateur par défaut prestashop et le mot de passe prestashop, puis cliquez sur Se connecter.

Assurez-vous que vos dépendances, configurations PHP et extensions PHP répondent aux exigences de PrestaShop. Si ce n’est pas le cas, vous pouvez ajuster vos paramètres en fonction des recommandations sur la page.

ps-checker

Téléchargement de Prestashop

Maintenant que le serveur MariaDB et PHP sont configurés, l’étape suivante consiste à télécharger le code source de PrestaShop et à configurer le répertoire d’installation avec les permissions et la propriété appropriées.

Déplacez votre répertoire de travail vers /var/www/ et téléchargez le code source de PrestaShop via la commande wget ci-dessous. Assurez-vous de vérifier la page de version de PrestaShop pour obtenir la dernière version de PrestaShop.

cd /var/www/  
wget https://github.com/PrestaShop/PrestaShop/releases/download/8.1.2/prestashop_8.1.2.zip

Maintenant, extrayez le code source de PrestaShop via la commande unzip ci-dessous. Vous devriez voir le code source de PrestaShop dans le fichier zip prestashop.zip.

unzip prestashop_8.1.2.zip

Extrayez le fichier prestashop.zip en utilisant la commande unzip ci-dessous vers le répertoire cible /var/www/prestashop. Le code source de PrestaShop sera extrait dans le répertoire prestashop, donc votre répertoire d’installation de Prestashop devrait être /var/www/prestashop.

unzip prestashop.zip -d /var/www/prestashop

Enfin, exécutez la commande suivante pour configurer la propriété et les permissions appropriées pour le répertoire d’installation de PrestaShop /var/www/prestashop. La propriété doit utiliser www-data avec la permission u+rw, ce qui signifie que le propriétaire peut lire et écrire dans le répertoire cible.

sudo chown -R www-data:www-data /var/www/prestashop  
sudo chmod u+rw /var/www/prestashop

Configuration de l’hôte virtuel Apache2

Dans l’étape suivante, vous allez créer une nouvelle configuration d’hôte virtuel Apache2 qui sera utilisée pour exécuter PrestaShop. Avant cela, assurez-vous que votre nom de domaine est pointé vers une adresse IP de serveur.

Pour commencer, exécutez la commande suivante pour activer le module rewrite pour Apache.

sudo a2enmod rewrite

enable rewrite

Ensuite, créez une nouvelle configuration d’hôte virtuel /etc/apache2/sites-available/prestashop.conf en utilisant la commande de l’éditeur nano.

sudo nano /etc/apache2/sites-available/prestashop.conf

Insérez la configuration suivante et assurez-vous de changer le nom de domaine dans le paramètre ServerName.

  
  
    ServerAdmin [email protected]  
    DocumentRoot /var/www/prestashop  
    ServerName howtoforge.local  
  
      
        # activer les réécritures .htaccess  
        AllowOverride All  
        Options +Indexes  
        Require all granted  
         
        # Désactiver le token du back office  
        # SetEnv _TOKEN_ disabled  
      
  
    ErrorLog /var/log/apache2/prestashop.error.log  
    CustomLog /var/log/apache2/prestashop.access.log combined

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour activer le fichier d’hôte virtuel prestashop.conf et vérifier votre configuration Apache.

sudo a2ensite prestashop.conf  
sudo apachectl configtest

Si vous avez une configuration Apache correcte, la sortie Syntax OK sera affichée.

setup vhost

Maintenant, exécutez la commande systemctl ci-dessous pour redémarrer le service apache2 et appliquer les modifications.

sudo systemctl restart apache2

Enfin, générez les certificats SSL/TLS pour votre nom de domaine PrestaShop en exécutant la commande certbot suivante. Assurez-vous de changer l’adresse e-mail et le nom de domaine avec vos informations.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Une fois le processus terminé, votre fichier d’hôte virtuel prestashop.conf sera automatiquement configuré avec HTTPS et vos certificats SSL/TLS seront disponibles dans le répertoire /etc/letsencrypt/live/howtoforge.local.

Installation de PrestaShop via la ligne de commande

À ce stade, vous pouvez maintenant terminer votre installation de PrestaShop via l’interface web ou la ligne de commande. Dans cet exemple, vous terminerez votre installation de PrestaShop via la ligne de commande.

Allez dans le répertoire d’installation de PrestaShop /var/www/prestashop/install.

cd /var/www/prestashop/install

Exécutez le script index_cli.php comme suit pour commencer l’installation de PrestaShop via la ligne de commande. Assurez-vous de changer les détails d’un nom de domaine, d’un hôte de base de données MariaDB, de nom, d’utilisateur et de mot de passe. Assurez-vous également de changer l’adresse e-mail et le mot de passe qui seront utilisés comme administrateur pour PrestaShop.

sudo -u www-data php index_cli.php --domain=howtoforge.local --db_server=127.0.0.1 --db_name=prestashopdb --db_user=prestashop --db_password=password --prefix=myps_ [email protected] --password=Passw0rd

Une fois l’installation terminée, la sortie “ Installation réussie “ sera affichée comme suit.

install prestashop via command line

Ensuite, exécutez la commande suivante pour configurer les permissions appropriées pour certains répertoires de PrestaShop. Cela permettra à www-data d’être le propriétaire pour lire et écrire dans ces répertoires cibles.

sudo chmod u+rw /var/www/prestashop/var/cache  
sudo chmod u+rw /var/www/prestashop/var/logs  
sudo chmod u+rw /var/www/prestashop/img  
sudo chmod u+rw /var/www/prestashop/mails  
sudo chmod u+rw /var/www/prestashop/modules  
sudo chmod u+rw /var/www/prestashop/translations  
sudo chmod u+rw /var/www/prestashop/upload  
sudo chmod u+rw /var/www/prestashop/download  
sudo chmod u+rw /var/www/prestashop/app/config  
sudo chmod u+rw /var/www/prestashop/app/Resources/translations

Maintenant, exécutez la commande ci-dessous pour supprimer le répertoire /var/www/prestashop/install et sécuriser votre installation PrestaShop.

sudo rm -rf /var/www/prestashop/install

Ensuite, ouvrez votre navigateur web et visitez votre nom de domaine PrestaShop, tel que http://howtoforge.local/. Une fois l’installation réussie, vous devriez être redirigé vers une connexion HTTPS sécurisée, et vous devriez voir la page d’accueil par défaut de votre installation PrestaShop.

prestashop homepage

Ensuite, visitez le nom de domaine PrestaShop suivi du chemin admin, tel que https://howtoforge.local/admin/. Si tout se passe bien, vous devriez être redirigé vers la page de connexion PrestaShop. Vous pouvez également voir que le chemin URL par défaut pour PrestaShop a changé en admin051rgjztgtkvgcie6dp.

Entrez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

Si vous avez un utilisateur admin et un mot de passe corrects, vous devriez être présenté avec le tableau de bord d’administration de PrestaShop.

prestashop dashboard

Une autre considération, vous pouvez exécuter la commande suivante pour vérifier la connexion admin de PrestaShop.

ls /var/www/prestashop

La sortie ci-dessous montre que la page d’administration de PrestaShop est disponible à admin051rgjztgtkvgcie6dp.

check ps admin

Conclusion

Pour conclure, vous avez maintenant installé avec succès PrestaShop sur Debian 12 étape par étape. Vous avez installé PrestaShop 8 avec la pile LAMP (Apache2, MariaDB et PHP) et sécurisé l’installation de PrestaShop avec des certificats SSL/TLS. De plus, vous avez également appris comment commencer l’installation de PrestaShop via la ligne de commande. Maintenant, vous pouvez ajouter de nouveaux thèmes et extensions supplémentaires pour étendre votre installation PrestaShop.