CONVIRO
Engineering

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,…

Conviro
19. November 20267 Min. Lesezeit
Magento 2 Extension per Composer installieren: Schritt-für-Schritt-Anleitung
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:enable vorher, bin/magento maintenance:disable danach.

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:

  1. composer require lädt das Paket nach vendor/ herunter und trägt es in composer.json und composer.lock ein. Committen Sie beide Dateien, damit jede Umgebung dieselbe Version installiert.
  2. module:enable registriert das Modul in app/etc/config.php.
  3. setup:upgrade spielt 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.

  1. Trennen Sie die Verbindung im Conviro-Einrichtungsassistenten.
  2. Deaktivieren Sie das Modul: bin/magento module:disable Conviro_AiChat
  3. Entfernen Sie das Paket: composer remove conviro/module-aichat
  4. Führen Sie bin/magento setup:upgrade aus.

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.

Teilen:

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