Magento 2 Extension per Composer installieren: Schritt-für-Schritt-Anleitung
Praxisnahe Anleitung, wie Sie eine Magento 2 Extension per Composer installieren: private Repositorys, auth.json, setup:upgrade, Schritte im Produktionsmodus, Updates,…

In diesem Artikel
Wenn Sie eine Magento 2 Extension per Composer installieren, fügen Sie zuerst das Repository des Anbieters hinzu (bei einem privaten Repository samt Zugangsdaten), führen composer require aus, aktivieren das Modul und starten bin/magento setup:upgrade. Läuft der Shop im Produktionsmodus, kompilieren Sie anschließend und deployen die statischen Inhalte; zum Schluss leeren Sie den Cache. Das sind nur eine Handvoll Befehle, aber Reihenfolge und Deploy-Modus sind entscheidend.
Diese Anleitung geht den kompletten Ablauf am Beispiel der kostenlosen Extension Conviro for Magento durch und behandelt danach Updates, Deinstallation und die Fehler, auf die Sie am ehesten stoßen.
Das Wichtigste in Kürze
- Führen Sie jeden Befehl im Magento-Root-Verzeichnis als Eigentümer des Dateisystems aus, nach einem Backup und zuerst auf Staging.
- Im Entwicklermodus genügen setup:upgrade und ein Cache-Flush; im Produktionsmodus kommen die Kompilierung und das Deployment der statischen Inhalte hinzu.
- Deinstallieren Sie in umgekehrter Reihenfolge: zuerst die Integration aufräumen, dann deaktivieren, entfernen und setup:upgrade ausführen.
Bevor Sie starten: Voraussetzungen
Prüfen Sie diese Punkte, bevor Sie die Produktion anfassen:
- SSH-Zugriff und Composer auf dem Server. Eine Installation per Composer lässt sich nicht über den Admin-Bereich erledigen.
- Ein aktuelles Backup von Code und Datenbank, idealerweise auch eine Staging-Kopie zum Testen.
- Der richtige Benutzer. Führen Sie die Befehle als Eigentümer des Dateisystems aus, nicht als root, sonst handeln Sie sich Probleme mit den Dateiberechtigungen ein.
- Ihr Deploy-Modus. Prüfen Sie ihn mit
bin/magento deploy:mode:show. - Ein Wartungsfenster für die Produktion:
bin/magento maintenance:enablevorher,bin/magento maintenance:disabledanach.
Speziell für die Conviro-Extension brauchen Sie außerdem Magento Open Source 2.4.4 oder neuer mit PHP 7.4 oder 8.1–8.4, eine Shop-URL mit HTTPS, einen laufenden Magento-Cron und ausgehendes HTTPS zu api.conviro.io. Die Extension (zum Zeitpunkt des Schreibens Version 1.4.1) wurde per Testinstallation geprüft auf:
| Magento | PHP | Theme |
|---|---|---|
| 2.4.4-p13 | 8.1 | Luma |
| 2.4.7-p4 | 8.3 | Luma |
| 2.4.9 | 8.4 | Luma und Hyvä 1.5.2 |
Adobe Commerce läuft auf demselben Framework, wurde aber noch nicht getestet. Hyvä Checkout ist ungetestet, und Shops mit 2.4.0–2.4.3 bleiben bei Extension 1.3.5.
Magento 2 Extension per Composer installieren: Schritt für Schritt
Schritt 1: Composer-Repository und Zugangsdaten hinzufügen
Private Extensions werden über das eigene Composer-Repository des Anbieters ausgeliefert. Im Magento-Root-Verzeichnis:
composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <CONVIRO_API_KEY>
Der erste Befehl trägt das Repository in die composer.json ein. Der zweite speichert die Zugangsdaten in der auth.json direkt daneben. Bei Conviro lautet der Benutzername api, das Passwort ist ein API-Schlüssel aus Developers → API Keys im Conviro-Dashboard. Mehr zur API von Conviro finden Sie auf der Entwicklerseite.
Halten Sie die auth.json aus der Versionskontrolle heraus. Ihre Schlüssel für repo.magento.com liegen meist in derselben Datei.
Schritt 2: composer require und setup:upgrade ausführen
composer require conviro/module-aichat
bin/magento module:enable Conviro_AiChat
bin/magento setup:upgrade
Diese drei Befehle sind der Kern jeder Modulinstallation in Magento 2:
composer requirelädt das Paket nachvendor/herunter und trägt es incomposer.jsonundcomposer.lockein. Committen Sie beide Dateien, damit jede Umgebung dieselbe Version installiert.module:enableregistriert das Modul inapp/etc/config.php.setup:upgradespielt die Schema- und Data-Patches des Moduls in die Datenbank ein und aktualisiert die Modulregistrierung.
Schritt 3: Kompilieren, deployen, Cache leeren
Im Produktionsmodus werden generierter Code und statische Dateien nicht bei Bedarf erzeugt. Führen Sie daher aus:
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
Im Entwicklermodus lassen Sie beides weg. In beiden Modi schließen Sie ab mit:
bin/magento cache:flush
Prüfen Sie dann, ob das Modul aktiv ist, und beenden Sie den Wartungsmodus:
bin/magento module:status Conviro_AiChat
bin/magento maintenance:disable
Schritt 4: Extension im Admin verbinden
Die meisten Extensions müssen nach der Installation konfiguriert werden. Bei Conviro öffnen Sie Stores › Settings › Conviro Setup. Ein Assistent mit 7 Schritten führt zuerst eine Umgebungsprüfung durch; danach klicken Sie auf „Connect to Conviro“, geben den Shop im Conviro-Dashboard frei und kehren zu Magento zurück. Es wird weder ein API-Schlüssel noch ein Token in Magento kopiert.
Der Assistent legt eine Magento-Integration mit minimalen Rechten (OAuth 1.0a) an, lässt Sie Store Views auswählen sowie festlegen, was synchronisiert wird und welche KI-Aktionen erlaubt sind, und prüft alles mit einem Test-Event. Danach prüft die Karte Integration Health unter Stores › Configuration › Conviro › AI Chat Verbindung, Authentifizierung, Webhooks, Katalog, Bestellungen, Cron, Version und Umgebung und liefert Anleitungen zur Behebung. Die Installationsseite und die Installationsdokumentation beschreiben jeden Schritt. Für die Verbindung brauchen Sie einen Conviro-Tarif mit API-Zugriff, also Pro oder höher (siehe Preise).
Magento 2 Modul aktualisieren und deinstallieren
Aktualisieren
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
Wie zuvor gilt: Kompilieren und deployen Sie nur im Produktionsmodus. Sobald eine neue Version erscheint, zeigt der Magento-Admin einen Hinweis mit dem genauen Befehl. Konfiguration, API-Schlüssel und Integration bleiben erhalten.
Deinstallieren
Die Reihenfolge ist wichtig: Die Verbindung wird im Einrichtungsassistenten getrennt, und der ist weg, sobald das Modul entfernt wurde.
- Trennen Sie die Verbindung im Conviro-Einrichtungsassistenten.
- Deaktivieren Sie das Modul:
bin/magento module:disable Conviro_AiChat - Entfernen Sie das Paket:
composer remove conviro/module-aichat - Führen Sie
bin/magento setup:upgradeaus.
Im Produktionsmodus kompilieren Sie danach wie gewohnt neu, deployen die statischen Inhalte erneut und leeren den Cache. Conviro löscht die Daten des Shops 30 Tage nach dem Trennen der Verbindung, auf Wunsch auch sofort. Die Deinstallationsdokumentation führt jeden Schritt auf.
Häufige Fehler bei der Installation und wie Sie sie beheben
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| „Allowed memory size exhausted“ bei Composer | PHP-Speicherlimit | COMPOSER_MEMORY_LIMIT=-1 composer require ... ausführen |
| Bei der Kompilierung reicht der Speicher nicht | Speicherlimit der CLI | php -d memory_limit=2G bin/magento setup:di:compile ausführen |
| 401 oder Abfrage der Zugangsdaten durch das Repository | Falscher Schlüssel oder Benutzername | http-basic-Befehl erneut ausführen; der Benutzername ist api |
„Permission denied“ in generated/, var/ oder pub/static/ |
Befehle als root oder als falscher Benutzer ausgeführt | Eigentümerrechte korrigieren, dann als Eigentümer des Dateisystems erneut ausführen |
| „Please upgrade your database“ | setup:upgrade nicht ausgeführt | bin/magento setup:upgrade ausführen |
| Daten werden nicht mehr synchronisiert, Health-Karte meldet Cron | Cron läuft nicht | bin/magento cron:install ausführen und crontab -l prüfen |
Cron ist wichtiger, als es scheint. Conviro schreibt Events aus Checkout, Kundenregistrierung und dem Speichern von Produkten in eine lokale Warteschlange, die der Magento-Cron im Hintergrund ausliefert. Die Extension ist außerdem so gebaut, dass Storefront-Seiten Conviro nicht per PHP aufrufen und Bestellungen auch dann verarbeitet werden, wenn Conviro nicht erreichbar ist. Testen Sie den gesamten Ablauf zuerst auf Staging; nach der Installation hilft Ihnen unsere Checkliste zum Testen von KI-Chatbots.
Häufig gestellte Fragen
Muss ich setup:di:compile im Entwicklermodus ausführen?
Nein. Im Entwicklermodus wird Code bei Bedarf generiert, daher genügen nach der Installation eines Moduls setup:upgrade und cache:flush. Im Produktionsmodus führen Sie zusätzlich setup:di:compile und setup:static-content:deploy aus. Sonst können Storefront und Admin ausfallen, weil generierter Code und statische Dateien fehlen.
Wo speichert Composer die Zugangsdaten für ein privates Repository?
composer config http-basic.<host> <user> <password> schreibt sie in die auth.json im Projekt-Root, neben die composer.json. Mit --global speichern Sie sie stattdessen im Composer-Home-Verzeichnis Ihres Benutzers. In beiden Fällen gehört die auth.json nicht in die Versionskontrolle, damit keine Schlüssel nach außen gelangen.
Wie prüfe ich, ob ein Magento 2 Modul aktiviert ist?
Mit bin/magento module:status listen Sie aktivierte und deaktivierte Module auf; alternativ hängen Sie den Modulnamen an, zum Beispiel bin/magento module:status Conviro_AiChat. Wird es als deaktiviert angezeigt, führen Sie module:enable aus, danach setup:upgrade, und leeren den Cache.
Kann ich eine Magento Extension ohne SSH-Zugriff installieren?
Nicht mit Composer. Die Conviro-Extension braucht SSH- oder CLI-Zugriff und Composer auf dem Server. Stellt Ihr Hoster das nicht bereit, bitten Sie Ihren Hosting-Anbieter oder Ihre Agentur, die Installation durchzuführen. Im Enterprise-Tarif installiert das Conviro-Team die Extension ohne Aufpreis.
Nächste Schritte
Installieren Sie zuerst auf Staging, durchlaufen Sie den Einrichtungsassistenten und prüfen Sie die Karte Integration Health, bevor Sie das Ganze in der Produktion wiederholen. Einen vollständigen Überblick, was die Extension nach der Verbindung leistet, gibt unsere Übersicht zur Magento 2 Chat Extension mit KI. Bereit zum Verbinden? Erstellen Sie Ihr Conviro-Konto.
Veröffentlicht von
Conviro
Teilt Erkenntnisse zu KI-gestütztem Kundenservice, Chatbot-Automatisierung und SaaS-Wachstumsstrategien.
Auf Conviro aufbauen
Verbinden Sie Konversations-Workflows mit Ihrem Tech-Stack
Prüfen Sie Entwicklerressourcen und Integrationsmuster, bevor Sie die Implementierung planen.
Ähnliche Artikel
Mehr Beiträge
Engineering
IMAP oder POP3 und SMTP erklärt: Ein Support-Postfach mit einem KI-Assistenten verbinden
7 Min. Lesezeit
Artikel lesen
Engineering
Was ist ein Webhook? Chatbot-Webhooks einfach erklärt für Nicht-Entwickler
7 Min. Lesezeit
Artikel lesen
Engineering
Wenn Messaging-Kanäle verstummen: Kanal-Monitoring für WhatsApp, Instagram und Web-Chat
7 Min. Lesezeit
Artikel lesen