Comment installer Magento 2 (2026): Guide d'installation complet pour les débutants - FR

Magento est l'une des plateformes de commerce électronique les plus puissantes disponibles. Mais l'installer? C'est là que la plupart des gens restent bloqués. Contrairement aux plateformes plus simples, Magento a besoin de configurations de serveur spécifiques, moteurs de recherche, et une configuration soignée. Sauter une étape, et vous passerez des heures à dépanner.

Ce guide vous guide à travers l'ensemble de Magento 2 processus d'installation. Vous apprendrez ce dont votre serveur a besoin, comment installer à l'aide de Composer (la méthode recommandée), et comment tout configurer correctement. Que vous mettiez en place un environnement de développement ou un magasin de production, ces étapes s'appliquent.

Un petit mot sur les versions: Magento Open Source 2.4.8 est la version actuelle. Adobe a renommé Magento Commerce en Adobe Commerce, mais la version open source reste gratuite. Ce guide couvre à la fois, bien que le processus d'installation soit presque identique.

Dernière mise à jour: février 2026. Toutes les exigences et commandes vérifiées par rapport à la documentation actuelle.

Configuration système requise pour Magento

Magento est gourmand en ressources. Il ne fonctionnera pas sur un hébergement mutualisé bon marché. Avant de commencer, confirmez que votre serveur répond à ces exigences.

Système opérateur

Magento nécessite Linux x86-64. Ubuntu 22.04 ou 24.04 LTS, RHEL, CentOS, et Debian fonctionnent tous. Windows et macOS ne sont pas pris en charge pour la production. Vous pouvez utiliser macOS pour le développement local, mais ne déployez pas dessus.

Serveur Web

Vous avez besoin soit d'Apache 2.4 ou Nginx 1.18 (ou plus tard). Apache nécessite que mod_rewrite soit activé. Nginx est souvent préféré pour ses performances, mais les deux fonctionnent bien. Choisissez en fonction de votre familiarité.

Exigences PHP

Magento 2.4.7 et 2.4.8 nécessite PHP 8.1 ou 8.2. Les versions antérieures ne fonctionneront pas. Vous aurez également besoin d’extensions PHP spécifiques installées:

• ext-bcmath
• type-ext
• boucle externe
• ext-dom
• ext-gd
• ext-intl
• chaîne externe
• ext-openssl
• ext-pdo_mysql
• savon ext
• ext-xsl
• zip externe
• prises externes

La configuration PHP compte aussi. Ensemble memory_limit à au moins 2 Go. Augmenter max_execution_time à 18000 pour l'installation. Activer OPcache (un booster de performances PHP) pour une exécution plus rapide.

Base de données

Magento 2.4.7 et plus tard nécessitent MySQL 8.0 ou MariaDB 10.4 (ou plus). Les versions antérieures de MySQL ne fonctionneront pas. La base de données nécessite la prise en charge du moteur de stockage InnoDB et un encodage UTF-8 approprié..

Moteur de recherche (Requis)

Voici ce qui fait trébucher beaucoup de gens: Magento 2.4+ nécessite un moteur de recherche. MySQL ne gère plus les recherches dans le catalogue. Vous devez installer soit:

• Recherche élastique 7.17 ou 8.x
• Recherche ouverte 1.2 ou 2.x (un fork d'Elasticsearch, entièrement compatible)

OpenSearch est recommandé pour les nouvelles installations. Il est open source et reçoit des mises à jour régulières. Nous aborderons son installation plus tard.

Exigences supplémentaires

• Compositeur 2.2+ – Gestionnaire de dépendances PHP (requis pour l'installation)
• RAM – Minimum 2 Go, 4Go recommandé
• Espace de rangement – Au moins 10 Go de SSD (NVMe préféré)
• Certificat SSL – Obligatoire pour HTTPS (l'auto-signé ne fonctionnera pas)
• TLS 1.2 – Requis pour l'accès aux référentiels PayPal et Magento

Hébergement recommandé

Hébergement partagé ne fonctionnera pas pour Magento. Vous avez besoin d'un VPS ou serveur dédié avec accès root complet. Attendez-vous à dépenser au moins 20 à 50 $/mois pour des ressources adéquates. Pour les magasins à fort trafic, serveurs dédiés ou hébergement cloud offrir une meilleure évolutivité.

Pré-installation: Préparation du serveur

Avant d'installer Magento, votre serveur a besoin d'une configuration appropriée. Ces étapes supposent qu'Ubuntu 22.04, mais les commandes sont similaires pour les autres distributions.

Étape 1: Mettez à jour votre système

Commencez avec une nouvelle mise à jour du système:

sudo apt update && sudo apt upgrade -y

Étape 2: Installer PHP et les extensions requises

Ajoutez le référentiel PHP et installez PHP 8.2 avec toutes les extensions requises:

sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.2 php8.2-fpm php8.2-mysql php8.2-xml php8.2-curl php8.2-gd php8.2-intl php8.2-mbstring php8.2-soap php8.2-xsl php8.2-zip php8.2-bcmath php8.2-sockets -y

Étape 3: Configurer les paramètres PHP

Editez votre fichier de configuration PHP:

sudo nano /etc/php/8.2/fpm/php.ini

Rechercher et modifier ces valeurs:

memory_limit = 2G
max_execution_time = 18000
zlib.output_compression = On

Redémarrez PHP-FPM (Gestionnaire de processus PHP FastCGI) pour appliquer les modifications:

sudo systemctl restart php8.2-fpm

Étape 4: Installer MySQL 8.0

sudo apt install mysql-server -y
sudo mysql_secure_installation

Créer une base de données et un utilisateur pour Magento:

sudo mysql -u root -p

CREATE DATABASE magento2;
CREATE USER 'magento_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON magento2.* TO 'magento_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Étape 5: Installer Nginx

sudo apt install nginx -y
sudo systemctl enable nginx

Étape 6: Installer Composer

Composer gère les dépendances de Magento. Installez-le globalement:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

Vérifier le compositeur 2.2+ est installé. Les anciennes versions provoquent des problèmes de dépendance.

Étape 7: Installer OpenSearch

OpenSearch nécessite Java. Installez d'abord OpenJDK:

sudo apt install openjdk-11-jdk -y

Ajoutez le référentiel OpenSearch et installez:

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | sudo apt-key add -
echo "deb https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-2.x.list
sudo apt update
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=YourSecurePassword123! apt install opensearch -y

Configurez OpenSearch en modifiant /etc/opensearch/opensearch.yml:

cluster.name: magento2
network.host: localhost
http.port: 9200
discovery.type: single-node
plugins.security.disabled: true

Démarrer et activer le service:

sudo systemctl enable opensearch
sudo systemctl start opensearch

Vérifiez qu'il fonctionne:

curl -X GET "localhost:9200"

Vous devriez voir une réponse JSON avec des informations sur le cluster.

Installer Magento via Composer

La méthode Composer est la seule approche d'installation recommandée. Il gère correctement les dépendances et simplifie les mises à jour. Évitez les téléchargements d'archives ou les clones Git pour les sites de production.

Étape 1: Obtenez les clés d'authentification Magento

Vous avez besoin de clés d'authentification pour télécharger Magento. Créez un compte gratuit sur place de marché.magento.com, puis:

1. Go to My Profile > Access Keys
2. Cliquez sur “Créer une nouvelle clé d'accès”
3. Nommez-le (par exemple, “Installation du serveur”)
4. Copiez la clé publique (Nom d'utilisateur) et clé privée (mot de passe)

Stockez ces clés dans le fichier d'authentification global de Composer:

composer global config http-basic.repo.magento.com <public_key> <private_key>

Étape 2: Créer l'annuaire Web

Créez et accédez à votre racine Web:

sudo mkdir -p /var/www/magento2
cd /var/www/magento2

Étape 3: Télécharger Magento

Exécutez la commande Composer create-project. Pour Magento Open Source:

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition .

Pour Adobe Commerce (version payante):

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition .

Cela télécharge plus de 300 Mo de fichiers. Sois patient.

Étape 4: Définir les autorisations de fichier

Les autorisations appropriées empêchent “Accès refusé” erreurs et problèmes de sécurité:

sudo find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
sudo find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;
sudo chown -R www-data:www-data /var/www/magento2
sudo chmod u+x bin/magento

Étape 5: Exécutez la commande d'installation

Maintenant, lancez l'installation proprement dite. Personnalisez ces paramètres pour votre configuration:

bin/magento setup:install \
  --base-url="https://yourdomain.com/" \
  --db-host="localhost" \
  --db-name="magento2" \
  --db-user="magento_user" \
  --db-password="your_strong_password" \
  --admin-firstname="Admin" \
  --admin-lastname="User" \
  --admin-email="[email protected]" \
  --admin-user="admin" \
  --admin-password="Admin123!" \
  --language="en_US" \
  --currency="USD" \
  --timezone="America/New_York" \
  --use-rewrites=1 \
  --search-engine="opensearch" \
  --opensearch-host="localhost" \
  --opensearch-port="9200"

L'installation prend 5-15 minutes en fonction de la vitesse du serveur. Surveillez les erreurs.

Une fois terminé, vous verrez un message avec votre URL d'administrateur. C'est randomisé pour des raisons de sécurité (par exemple, /admin_abc123). Écrivez ceci.

Étape 6: Exécuter les commandes post-installation

Terminez la configuration avec ces commandes essentielles:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

le static-content:deploy la commande génère des fichiers CSS et JavaScript. le -f le drapeau force le déploiement en mode développeur.

Configuration de Nginx pour Magento

Magento nécessite une configuration Nginx spécifique. Créer un nouveau bloc serveur:

sudo nano /etc/nginx/sites-available/magento2

Ajouter cette configuration (ajuster le domaine et les chemins):

upstream fastcgi_backend {
    server unix:/var/run/php/php8.2-fpm.sock;
}

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    set $MAGE_ROOT /var/www/magento2;
    set $MAGE_MODE production;

    include /var/www/magento2/nginx.conf.sample;
}

Activer le site et tester la configuration:

sudo ln -s /etc/nginx/sites-available/magento2 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Magento fournit un exemple de configuration Nginx sur nginx.conf.sample. La directive include ci-dessus l'utilise directement.

Configuration des tâches Cron

Magento s'appuie fortement sur les tâches cron (tâches planifiées) pour l'indexation, courriels, plans de site, et plus. Sans cron, votre boutique ne fonctionnera pas correctement.

Exécutez cette commande pour générer les entrées crontab:

bin/magento cron:install

Cela ajoute trois tâches cron. Vérifiez qu'ils existent:

crontab -l

Vous devriez voir des entrées s'exécuter toutes les minutes pour les tâches planifiées de Magento.

Optimisation des performances: Redis et vernis

Un magasin Magento de production a besoin d'une mise en cache pour des performances acceptables. Redis gère les sessions et le cache backend. Vernis (un accélérateur HTTP) gère la mise en cache d'une page entière.

Installation de Redis

sudo apt install redis-server -y
sudo systemctl enable redis-server

Vérifier que Redis fonctionne:

redis-cli ping

Il devrait répondre avec “PONG”.

Configurer Magento pour utiliser Redis pour la mise en cache:

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
bin/magento setup:config:set --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-db=2

Utiliser des bases de données distinctes (0, 1, 2) maintient les différents types de cache isolés.

Installation du vernis

Varnish se trouve devant votre serveur Web et met les pages en cache:

sudo apt install varnish -y

Magento génère le fichier de configuration Varnish:

bin/magento varnish:vcl:generate --backend-host=localhost --backend-port=8080 --output-file=/etc/varnish/default.vcl

Vous devrez ajuster Nginx pour écouter sur le port 8080 en interne tandis que Varnish gère le port 80. Cette configuration nécessite une configuration supplémentaire au-delà de la portée de ce guide, mais la documentation Magento le couvre en détail.

Configuration de la sécurité

Sécuriser Magento nécessite plusieurs étapes. Ne les sautez pas.

Sécurité du panneau d'administration

Log into the Magento admin panel and navigate to Stores > Configuration > Advanced > Admin.

Sous sécurité, configurer ces paramètres:

• Partage de compte administrateur: Régler sur “Non” (empêche plusieurs personnes d'utiliser une seule connexion)
• Durée de vie du mot de passe: Régler sur 90 journées
• Nombre maximal d'échecs de connexion: Régler sur 5
• Temps de verrouillage: Régler sur 30 minutes

Authentification à deux facteurs

Magento 2.4+ permet l'authentification à deux facteurs (2FA) par défaut. Cela ajoute une deuxième étape de vérification au-delà des mots de passe. Vous ne pouvez pas le désactiver, alors configurez-le correctement:

1. Go to Stores > Configuration > Security > 2FA
2. Activer l'authentificateur Google (ou un autre fournisseur pris en charge)
3. Lors de la première connexion, scannez le code QR avec votre application d'authentification

Autorisations de fichiers

Après l'installation, resserrer les autorisations:

sudo find /var/www/magento2 -type d -exec chmod 755 {} \;
sudo find /var/www/magento2 -type f -exec chmod 644 {} \;
sudo chmod -R 770 /var/www/magento2/var
sudo chmod -R 770 /var/www/magento2/pub/static
sudo chmod -R 770 /var/www/magento2/pub/media
sudo chmod -R 770 /var/www/magento2/generated

URL d'administration

Magento génère une URL d'administration aléatoire lors de l'installation. Gardez-le ainsi. Ne le change pas en quelque chose de prévisible comme /admin. Si vous devez le retrouver plus tard:

bin/magento info:adminuri

Configuration SSL/HTTPS

Utilisez toujours HTTPS en production. Après avoir installé un certificat SSL (Let's Encrypt est gratuit), configurer Magento:

bin/magento setup:store-config:set --base-url="https://yourdomain.com/"
bin/magento setup:store-config:set --base-url-secure="https://yourdomain.com/"
bin/magento setup:store-config:set --use-secure=1
bin/magento setup:store-config:set --use-secure-admin=1
bin/magento cache:flush

Dépannage des problèmes d'installation courants

Même avec une configuration soignée, des problèmes surviennent. Voici les problèmes et solutions les plus courants.

Installation bloquée à 70%

Cela signifie généralement que PHP max_execution_time est trop bas. Modifiez php.ini et réglez-le sur 18000, puis redémarrez PHP-FPM. Alternativement, exécutez l'installation via la ligne de commande au lieu du programme d'installation Web.

“La classe n'existe pas” les erreurs

Ces erreurs ReflectionException indiquent des fichiers générés corrompus. Effacez-les:

rm -rf var/cache var/page_cache var/generation generated/code
bin/magento setup:di:compile
bin/magento cache:flush

Erreurs de refus d'autorisation

Les autorisations de fichiers provoquent environ 38% des échecs d'installation. Assurez-vous que l'utilisateur du serveur Web (www-données sur Ubuntu) possède tous les fichiers:

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

Extension PHP manquante

Des messages d'erreur comme “L'extension PHP demandée ext-mbstring est manquante” ça veut dire que tu dois installer cette extension:

sudo apt install php8.2-mbstring -y
sudo systemctl restart php8.2-fpm

Échec de la connexion Elasticsearch/OpenSearch

Si Magento ne parvient pas à se connecter à votre moteur de recherche:

1. Vérifiez si le service est en cours d'exécution: sudo systemctl status opensearch
2. Tester la connectivité: curl localhost:9200
3. Vérifiez que les règles de pare-feu ne bloquent pas le port 9200
4. Vérifiez que le nom d'hôte et le port de votre commande d'installation correspondent à votre configuration

Mémoire épuisée

Les erreurs de mémoire PHP lors de la compilation signifient que vous avez besoin de plus de RAM ou d'espace de swap:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Pages vierges ou 500 les erreurs

Activer le mode développeur pour voir les erreurs réelles:

bin/magento deploy:mode:set developer

Vérifiez les fichiers journaux sur var/log/exception.log et var/log/system.log pour plus de détails.

Liste de contrôle post-installation

Après une installation réussie, complétez ces étapes:

• Connectez-vous au panneau d'administration et configurez les paramètres du magasin (Nom, fuseau horaire, devise)
• Configurer les méthodes d'expédition
• Configurer les passerelles de paiement
• Créer des groupes de clients et des règles fiscales
• Configurer des modèles d'e-mails et SMTP
• Configurer les robots.txt et les plans de site
• Installer les extensions essentielles via Composer
• Configurer des sauvegardes automatisées
• Passer en mode production: bin/magento deploy:mode:set production

Questions fréquemment posées

Puis-je installer Magento sur un hébergement mutualisé?

Techniquement oui, mais ce n'est pas recommandé. Magento nécessite des configurations PHP spécifiques, Accès SSH, et compositeur. La plupart des hébergeurs partagés ne les fournissent pas. Vous atteindrez également rapidement les limites de mémoire. Hébergement VPS est l'option pratique minimale.

Combien de temps prend l'installation de Magento?

La préparation du serveur prend 30-60 minutes si vous êtes familier avec Linux. L'installation réelle de Magento prend 10-20 minutes. Les nouveaux utilisateurs doivent prévoir un budget 2-4 heures pour le processus complet, y compris le dépannage.

Ai-je besoin d'Elasticsearch ou d'OpenSearch?

Oui, l'un d'eux est obligatoire pour Magento 2.4+. MySQL ne gère plus les recherches dans le catalogue. OpenSearch est le choix recommandé pour les nouvelles installations car il est entièrement open source et activement maintenu..

Quelle est la différence entre Magento Open Source et Adobe Commerce?

Magento Open Source est gratuit et soutenu par la communauté. Adobe Commerce (anciennement Magento Commerce) est la version payante avec des fonctionnalités supplémentaires telles que la fonctionnalité B2B, outils marketing avancés, et options d'hébergement cloud. Adobe Commerce commence à 22 000 $/an. Les deux partagent le même processus d’installation.

Puis-je migrer de WooCommerce vers Magento?

Oui, mais cela nécessite une planification minutieuse. Vous devrez exporter des produits, les clients, et les commandes de WooCommerce et importez-les dans Magento. Plusieurs extensions de migration existent, bien que les magasins complexes puissent nécessiter un développement personnalisé. Pensez à embaucher un spécialiste Magento pour les grands catalogues.

Comment mettre à jour Magento après l'installation?

Utiliser Composer pour mettre à jour: composer update magento/product-community-edition --with-all-dependencies. Sauvegardez toujours votre base de données et vos fichiers en premier. Tester les mises à jour sur un environnement de test avant la production. Courir bin/magento setup:upgrade après la mise à jour.

Pourquoi ma boutique Magento est-elle lente?

Magento non mis en cache est lent par conception. Il génère des pages dynamiquement. Activez Redis pour la mise en cache backend et Varnish pour la mise en cache pleine page. Activer le mode production, qui précompile le code. Utiliser un CDN pour les actifs statiques. Pensez à mettre à niveau votre ressources serveur si le trafic est élevé.