CONVIRO
Engineering

Installer un module Magento 2 avec Composer : le guide étape par étape

Un guide pratique pour installer un module Magento 2 avec Composer : dépôts privés, auth.json, setup:upgrade, étapes en mode production, mises à jour, désinstallation et erreurs…

Conviro
19 novembre 20267 min de lecture
Installer un module Magento 2 avec Composer : le guide étape par étape
Dans cet article

Pour installer un module Magento 2 avec Composer, vous ajoutez le dépôt de l'éditeur (et des identifiants s'il est privé), lancez composer require, activez le module, exécutez bin/magento setup:upgrade, compilez et déployez le contenu statique si la boutique est en mode production, puis videz le cache. Cela tient en quelques commandes, mais l'ordre et le mode de déploiement comptent.

Ce guide déroule la séquence complète en prenant comme exemple l'extension gratuite Conviro for Magento, puis aborde la mise à jour, la désinstallation et les erreurs que vous avez le plus de chances de rencontrer.

À retenir

  • Lancez chaque commande depuis la racine de Magento, en tant que propriétaire du système de fichiers, après une sauvegarde, et d'abord en préproduction.
  • Le mode développeur nécessite setup:upgrade et un vidage du cache ; le mode production exige en plus la compilation et le déploiement du contenu statique.
  • Désinstallez dans l'ordre inverse : nettoyez d'abord l'intégration, puis désactivez, supprimez et lancez setup:upgrade.

Avant de commencer : les prérequis

Vérifiez ces points avant de toucher à la production :

  • Un accès SSH et Composer sur le serveur. Une installation via Composer ne peut pas se faire depuis le back-office.
  • Une sauvegarde récente du code et de la base de données, et idéalement une copie de préproduction pour tester.
  • Le bon utilisateur. Lancez les commandes en tant que propriétaire du système de fichiers, pas en root, sinon vous créerez des problèmes de permissions.
  • Votre mode de déploiement. Vérifiez-le avec bin/magento deploy:mode:show.
  • Une fenêtre de maintenance pour la production : bin/magento maintenance:enable avant, bin/magento maintenance:disable après.

Pour l'extension Conviro en particulier, il vous faut aussi Magento Open Source 2.4.4 ou ultérieur avec PHP 7.4 ou 8.1 à 8.4, une URL de boutique en HTTPS, le cron Magento actif et des connexions HTTPS sortantes vers api.conviro.io. L'extension (version 1.4.1 au moment de la rédaction) a été testée à l'installation sur :

Magento PHP Thème
2.4.4-p13 8.1 Luma
2.4.7-p4 8.3 Luma
2.4.9 8.4 Luma et Hyvä 1.5.2

Adobe Commerce repose sur le même framework mais n'a pas encore été testé, Hyvä Checkout n'est pas testé, et les boutiques en 2.4.0–2.4.3 restent sur l'extension 1.3.5.

Installer un module Magento 2 avec Composer, étape par étape

Étape 1 : ajouter le dépôt Composer et les identifiants

Les extensions privées sont distribuées depuis le dépôt Composer de l'éditeur. Depuis la racine de Magento :

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <CONVIRO_API_KEY>

La première commande ajoute le dépôt à composer.json. La seconde enregistre les identifiants dans auth.json, juste à côté. Pour Conviro, le nom d'utilisateur est api et le mot de passe est une clé API créée dans Developers → API Keys du tableau de bord Conviro. Pour en savoir plus sur l'API de Conviro, consultez la page développeurs.

Ne versionnez pas auth.json. Vos clés repo.magento.com se trouvent généralement dans le même fichier.

Étape 2 : lancer composer require et setup:upgrade

composer require conviro/module-aichat
bin/magento module:enable Conviro_AiChat
bin/magento setup:upgrade

Ces trois commandes constituent le cœur de toute installation de module Magento 2 :

  1. composer require télécharge le paquet dans vendor/ et l'enregistre dans composer.json et composer.lock. Commitez les deux fichiers pour que chaque environnement installe la même version.
  2. module:enable enregistre le module dans app/etc/config.php.
  3. setup:upgrade applique le schéma de base de données et les data patches du module, et met à jour le registre des modules.

Étape 3 : compiler, déployer et vider le cache

En mode production, le code généré et les fichiers statiques ne sont pas construits à la demande. Lancez donc :

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

En mode développeur, sautez ces deux commandes. Dans les deux modes, terminez par :

bin/magento cache:flush

Vérifiez ensuite que le module est actif et quittez le mode maintenance :

bin/magento module:status Conviro_AiChat
bin/magento maintenance:disable

Étape 4 : connecter l'extension dans l'admin

La plupart des extensions doivent être configurées après l'installation. Pour Conviro, ouvrez Stores › Settings › Conviro Setup. Un assistant de configuration en 7 étapes vérifie l'environnement, puis vous cliquez sur Connect to Conviro, approuvez la boutique dans le tableau de bord Conviro et revenez dans Magento. Aucune clé API ni aucun jeton n'est copié dans Magento.

L'assistant crée une intégration Magento au moindre privilège (OAuth 1.0a), vous permet de choisir les store views, les données à synchroniser et les actions autorisées pour l'IA, puis vérifie le tout avec un événement de test. Ensuite, la carte Integration Health, sous Stores › Configuration › Conviro › AI Chat, vérifie la connexion, l'authentification, les webhooks, le catalogue, les commandes, le cron, la version et l'environnement, avec des instructions de correction. La page d'installation et la documentation d'installation détaillent chaque étape. La connexion nécessite une offre Conviro avec accès API, Pro ou supérieure (voir les tarifs).

Mettre à jour et désinstaller un module Magento 2

Mise à jour

composer update conviro/module-aichat
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Comme précédemment, compilez et déployez uniquement en mode production. L'admin Magento affiche une notification avec la commande exacte à la sortie d'une nouvelle version, et votre configuration, votre clé API et votre intégration sont conservées.

Désinstallation

L'ordre compte : la déconnexion se fait dans l'assistant de configuration, qui disparaît une fois le module supprimé.

  1. Déconnectez la boutique dans l'assistant de configuration Conviro.
  2. Désactivez le module : bin/magento module:disable Conviro_AiChat
  3. Supprimez le paquet : composer remove conviro/module-aichat
  4. Lancez bin/magento setup:upgrade.

En mode production, recompilez, redéployez le contenu statique et videz le cache comme d'habitude. Conviro supprime les données de la boutique 30 jours après la déconnexion, ou immédiatement si vous le souhaitez. La documentation de désinstallation liste chaque étape.

Erreurs courantes et comment les corriger

Symptôme Cause probable Solution
"Allowed memory size exhausted" pendant l'exécution de Composer Limite de mémoire PHP Lancez COMPOSER_MEMORY_LIMIT=-1 composer require ...
La compilation manque de mémoire Limite de mémoire en CLI Lancez php -d memory_limit=2G bin/magento setup:di:compile
Erreur 401 ou demande d'identifiants de la part du dépôt Mauvaise clé ou mauvais nom d'utilisateur Relancez la commande http-basic ; le nom d'utilisateur est api
"Permission denied" dans generated/, var/ ou pub/static/ Commandes lancées en root ou avec le mauvais utilisateur Corrigez les droits de propriété, puis relancez en tant que propriétaire du système de fichiers
"Please upgrade your database" setup:upgrade non exécuté Lancez bin/magento setup:upgrade
Les données ne se synchronisent plus, la carte de santé signale le cron Le cron ne tourne pas Lancez bin/magento cron:install et vérifiez crontab -l

Le cron compte plus qu'il n'y paraît. Conviro écrit les événements de passage de commande, de création de compte et d'enregistrement de produit dans une file d'attente locale que le cron Magento traite en arrière-plan. L'extension est aussi conçue pour que les pages de la boutique n'appellent pas Conviro depuis PHP et que les commandes continuent d'être traitées si Conviro est injoignable. Testez d'abord l'ensemble du parcours en préproduction ; notre checklist de test pour chatbot IA vous aidera après l'installation.

Questions fréquentes

Faut-il lancer setup:di:compile en mode développeur ?

Non. Le mode développeur génère le code à la demande : setup:upgrade et cache:flush suffisent après l'installation d'un module. En mode production, lancez aussi setup:di:compile et setup:static-content:deploy, sinon le front-office et l'admin peuvent planter faute de code généré et de fichiers statiques.

Où Composer stocke-t-il les identifiants d'un dépôt privé ?

composer config http-basic.<host> <user> <password> les écrit dans auth.json à la racine de votre projet, à côté de composer.json. Ajoutez --global pour les stocker plutôt dans le répertoire Composer de votre utilisateur. Dans les deux cas, ne versionnez pas auth.json, pour éviter toute fuite de clés.

Comment vérifier si un module Magento 2 est activé ?

Lancez bin/magento module:status pour lister les modules activés et désactivés, ou ajoutez le nom du module, par exemple bin/magento module:status Conviro_AiChat. S'il apparaît comme désactivé, lancez module:enable, puis setup:upgrade, et videz le cache.

Peut-on installer un module Magento sans accès SSH ?

Pas avec Composer. L'extension Conviro nécessite un accès SSH ou CLI et Composer sur le serveur. Si votre hébergement ne les fournit pas, demandez à votre hébergeur ou à votre agence de réaliser l'installation. Avec l'offre Enterprise, l'équipe Conviro installe l'extension sans surcoût.

Prochaines étapes

Faites l'installation en préproduction, déroulez l'assistant de configuration et vérifiez la carte Integration Health avant de répéter l'opération en production. Pour une présentation complète de ce que fait l'extension une fois connectée, lisez notre présentation du module chat IA pour Magento 2. Prêt à vous connecter ? Créez votre compte Conviro.

Partager :

Publié par

Conviro

Partage des analyses sur le support client par IA, l'automatisation des chatbots et les stratégies de croissance SaaS.

Développez avec Conviro

Connectez les workflows conversationnels à votre stack technique

Consultez les ressources développeurs et les modèles d’intégration avant de concevoir l’implémentation.

Articles associés

Plus d'articles