Wichtige Magento CLI Befehle – Der ultimative Entwickler-Guide

Kategorie: Magento Entwicklung | Lesezeit: ca. 15 Minuten | März 2025

Vollständige Magento CLI Befehlsreferenz

Die folgende Referenz listet alle wichtigen Magento CLI Befehle geordnet nach Kategorie auf. Jeder Befehl wird mit seiner genauen Syntax und einer praxisnahen Beschreibung dokumentiert.

bin/magento setup:upgrade && \
bin/magento setup:di:compile && \
bin/magento setup:static-content:deploy -f && \
bin/magento indexer:reindex && \
bin/magento cache:flush && \
bin/magento cache:clean

rm -rf generated/code/* generated/metadata/*
rm -rf var/view_preprocessed/* pub/static/frontend/*

Cache-Verwaltung

Magento CLI · bin/magento

Indexer-Verwaltung

Magento CLI · bin/magento

Setup & Deployment

Magento CLI · bin/magento

Modul-Management

Magento CLI · bin/magento

Konfiguration

Magento CLI · bin/magento

Wer mit Magento 2 arbeitet, kommt an der Kommandozeile nicht vorbei. Das Magento Command Line Interface (CLI) ist eines der mächtigsten Werkzeuge im täglichen Arbeitsalltag eines Magento-Entwicklers. Ob Cache leeren, Indexer anstoßen, Deployments durchführen oder Module verwalten – die Magento CLI Befehle bilden das Rückgrat einer professionellen Magento-Entwicklung und Administration.

In diesem umfassenden Guide erfährst du alles, was du über die wichtigsten Magento CLI Befehle wissen musst. Vom einfachen Cache-Flush bis zum komplexen Deployment-Prozess decken wir sämtliche Bereiche ab, die für Entwickler, DevOps-Ingenieure und Shop-Administratoren relevant sind. Dabei gehen wir nicht nur auf die reinen Befehle ein, sondern erläutern auch den Kontext, in dem du welchen Magento 2 Command sinnvoll einsetzt.

Was ist die Magento CLI und warum ist sie unverzichtbar?

Die Magento CLI – kurz für Command Line Interface – ist ein mächtiges Werkzeug, das Magento 2 von Haus aus mitbringt. Sie wird über das zentrale Skript bin/magento aufgerufen und ermöglicht es, nahezu alle administrativen und technischen Aufgaben direkt über die Konsole auszuführen. Im Gegensatz zu Magento 1, wo viele Aufgaben noch über die grafische Benutzeroberfläche erledigt werden mussten, hat Magento 2 die CLI deutlich ausgebaut und zu einem zentralen Bestandteil des Entwickler-Workflows gemacht.

Der größte Vorteil der Magento Konsole liegt in der Effizienz: Aufgaben, die über das Admin-Panel mehrere Klicks und Seitenladezeiten erfordern, lassen sich mit einem einzigen Magento CLI Befehl in Sekunden erledigen. Besonders in CI/CD-Pipelines (Continuous Integration / Continuous Deployment) ist die CLI absolut unverzichtbar. Kein automatisierter Deployment-Prozess funktioniert ohne die saubere Ausführung der entsprechenden Magento 2 Commands.

Darüber hinaus eröffnet die Magento CLI Entwicklern die Möglichkeit, eigene Commands zu schreiben und in das System zu integrieren. Das macht sie zu einem flexiblen und erweiterbaren Werkzeug, das weit über die Standardfunktionalitäten hinausgeht. Ob für Datenmigrationen, automatisierte Reports oder kundenspezifische Cronjobs – die CLI ist die ideale Schnittstelle für maßgeschneiderte Automatisierungen.

Grundlegende Verwendung: Zugriff auf die Magento CLI

Alle Magento CLI Befehle werden über das PHP-Skript bin/magento aufgerufen. Dieses Skript liegt im Wurzelverzeichnis deiner Magento-Installation. Um es korrekt zu nutzen, navigierst du zunächst in das Magento-Rootverzeichnis und rufst dann den gewünschten Befehl auf. Die grundlegende Syntax lautet:

php bin/magento [Befehl] [Optionen] [Argumente]

Auf vielen Systemen ist PHP direkt im PATH definiert, sodass du einfach bin/magento ohne das vorangestellte php aufrufen kannst. Auf Shared-Hosting-Umgebungen kann es jedoch notwendig sein, die genaue PHP-Version anzugeben, etwa php7.4 bin/magento oder php8.2 bin/magento. Stelle sicher, dass du die PHP-Version verwendest, die Magento auch intern nutzt, da unterschiedliche Versionen zu unvorhergesehenen Fehlern führen können.

Ein weiterer wichtiger Aspekt ist der Benutzer-Kontext. Magento CLI Befehle sollten grundsätzlich unter dem Webserver-Benutzer (z.B. www-data auf Ubuntu/Debian-Systemen) ausgeführt werden, um Berechtigungsprobleme bei Dateisystemoperationen zu vermeiden. In der Praxis empfiehlt sich die Nutzung von sudo -u www-data php bin/magento [Befehl] oder das Arbeiten mit einem dedizierten Deploy-User, der die korrekten Berechtigungen besitzt.

Magento Cache-Verwaltung per CLI – Schnell und zuverlässig

Cache-Probleme gehören zu den häufigsten Herausforderungen im Magento-Alltag. Änderungen an Templates, Konfigurationen oder Modulen werden nicht sofort sichtbar, weil Magento verschiedene Cache-Typen aggressiv einsetzt, um die Performance zu optimieren. Die Magento CLI Befehle zur Cache-Verwaltung sind daher die mit Abstand am häufigsten genutzten Commands im täglichen Entwickleralltag.

Mit php bin/magento cache:flush werden alle Cache-Speicher vollständig geleert. Dieser Befehl ist radikaler als php bin/magento cache:clean, da er nicht nur die Magento-eigenen Caches, sondern auch den zugrundeliegenden Cache-Speicher (wie Redis oder Varnish-interne Strukturen) bereinigt. Im Entwicklungsalltag ist der Cache-Flush das erste Mittel der Wahl, wenn Änderungen nicht angezeigt werden.

Für gezieltere Eingriffe bietet die Magento CLI die Möglichkeit, einzelne Cache-Typen zu aktivieren, zu deaktivieren oder gezielt zu bereinigen. Mit dem Befehl php bin/magento cache:status erhältst du einen schnellen Überblick über alle Cache-Typen und deren aktuellen Status. Dies ist besonders nützlich in Produktionsumgebungen, wo ein vollständiger Cache-Flush erhebliche Performance-Einbußen verursachen kann.

Magento Indexer per CLI steuern

Der Magento-Indexer ist für die Leistungsfähigkeit eines Magento-Shops von zentraler Bedeutung. Indizes speichern vorberechnete Daten in optimierten Datenbanktabellen, damit Such- und Navigationsfunktionen blitzschnell reagieren. Wenn Produkte, Preise oder Kategorien aktualisiert werden, müssen diese Indizes neu berechnet werden – das ist die Aufgabe des Indexers.

Per Magento CLI Befehl lässt sich der Reindex-Prozess präzise steuern. Mit php bin/magento indexer:status erhältst du einen Überblick über alle Indexer und ihren aktuellen Zustand. Ein Indexer im Status 'invalid' bedeutet, dass er neu berechnet werden muss, bevor die Änderungen im Frontend sichtbar werden. Mit php bin/magento indexer:reindex kannst du alle Indexer auf einmal neu berechnen lassen – ein Prozess, der je nach Shop-Größe und Produktanzahl einige Minuten dauern kann.

In der Praxis empfiehlt es sich, Indexer nicht pauschal neu zu berechnen, sondern gezielt nur diejenigen anzustoßen, die tatsächlich betroffen sind. Wenn du beispielsweise nur Preise geändert hast, reicht es, den Preisindexer neu zu berechnen: php bin/magento indexer:reindex catalog_product_price. Das spart erheblich Zeit und reduziert die Systemlast.

Ein weiterer wichtiger Aspekt der Indexer-Verwaltung per Magento CLI ist das Setzen des Indexer-Modus. Du kannst wählen zwischen 'Update on Save' (bei jeder Änderung wird sofort neu indiziert) und 'Update by Schedule' (Neuindizierung erfolgt geplant durch einen Cronjob). Für Produktivsysteme mit vielen gleichzeitigen Produktänderungen ist 'Update by Schedule' die performantere Wahl.

Im Kontext von Hyvä-Themes ist die Cache-Verwaltung per CLI besonders relevant. Da Hyvä auf TailwindCSS setzt und CSS-Dateien kompiliert werden müssen, führen Änderungen am Frontend-Code ohne entsprechendes Cache-Leeren zu inkonsistenten Darstellungen. In Kombination mit dem Hyvä-Deployment-Prozess sollte das Cache-Leeren immer als fester Schritt in deinem Workflow verankert sein.

Magento 2 Deployment-Prozess mit der CLI meistern

Der Deployment-Prozess in Magento 2 ist mehrstufig und klar strukturiert. Die Magento CLI Befehle für das Deployment bilden das Herzstück jeder professionellen Deployment-Pipeline. Ein typischer Deployment-Workflow umfasst mehrere aufeinander folgende Schritte, die in der richtigen Reihenfolge ausgeführt werden müssen, um einen stabilen und performanten Shop zu gewährleisten.

Der erste Schritt ist die Generierung der statischen Assets mit php bin/magento setup:static-content:deploy. Dieser Magento 2 Command compiliert alle CSS- und JavaScript-Dateien, kopiert statische Assets wie Bilder und Fonts in das pub/static-Verzeichnis und erstellt die für das Frontend notwendigen Dateien. Bei mehrsprachigen Shops solltest du die entsprechenden Sprachcodes als Parameter übergeben, z.B. php bin/magento setup:static-content:deploy de_DE en_US.

Vor dem Static-Content-Deploy sollte stets die Dependency Injection (DI) Compilation durchgeführt werden: php bin/magento setup:di:compile. Dieser Schritt analysiert alle PHP-Klassen und ihre Abhängigkeiten, erstellt Proxies und Factories und optimiert das DI-System erheblich. In Produktionsumgebungen führt die DI-Compilation zu deutlich kürzeren Ladezeiten, da Abhängigkeiten nicht mehr zur Laufzeit aufgelöst werden müssen.

Ein vollständiger Deployment-Ablauf sieht in der Praxis typischerweise so aus: Zunächst wird Magento in den Maintenance-Modus versetzt, dann Composer-Abhängigkeiten installiert, danach die DI-Compilation ausgeführt, anschließend Static Content deployed, daraufhin Datenbankmigrationen angewendet und abschließend der Maintenance-Modus deaktiviert und alle Caches geleert. Dieser Prozess kann und sollte in einem Shell-Skript oder einer CI/CD-Pipeline automatisiert werden.

Für Hyvä-Themes gilt beim Deployment eine Besonderheit: Da Hyvä TailwindCSS nutzt, muss vor dem Static-Content-Deploy noch der Node.js-Build-Prozess durchgeführt werden. Anschließend sorgt der normale Magento Deployment-Prozess via CLI für die korrekte Auslieferung der kompilierten CSS-Dateien.

Modul-Management und -Konfiguration über die Magento CLI

Module sind das Herzstück des Magento-Frameworks. Jede Funktionalität in Magento 2 ist als Modul implementiert – vom Produktkatalog über die Checkout-Logik bis hin zu Drittanbieter-Erweiterungen. Die Magento CLI bietet umfangreiche Möglichkeiten, Module zu verwalten, zu aktivieren, zu deaktivieren und zu konfigurieren.

Mit php bin/magento module:status erhältst du eine vollständige Liste aller installierten Module und ihren aktuellen Status. Das ist besonders nützlich, wenn du schnell prüfen möchtest, ob ein bestimmtes Modul aktiv ist oder nach einem Composer-Update neue Module in der Liste erschienen sind. Die Ausgabe unterscheidet dabei zwischen aktiven und deaktivierten Modulen.

Das Aktivieren und Deaktivieren von Modulen per Magento CLI ist einfach, birgt aber auch Risiken. Bevor du ein Modul deaktivierst, solltest du sicherstellen, dass keine anderen Module davon abhängig sind. Magento prüft das zwar beim Deaktivierungsbefehl, dennoch empfiehlt sich eine vorherige manuelle Prüfung der Abhängigkeiten. Nach dem Aktivieren oder Deaktivieren eines Moduls sind in der Regel weitere Schritte wie DI-Compilation und Cache-Leeren notwendig.

Ein oft unterschätzter Bereich der Magento CLI ist die Konfigurationsverwaltung. Mit php bin/magento config:set lassen sich Konfigurationswerte direkt über die Kommandozeile setzen, ohne das Admin-Panel öffnen zu müssen. Das ist besonders praktisch in Deployment-Szenarien, wo umgebungsspezifische Konfigurationen (z.B. API-Keys, Datenbankverbindungen) automatisiert gesetzt werden sollen. Mit php bin/magento config:show lassen sich bestehende Konfigurationswerte abfragen.

Datenbankmigrationen und Setup-Upgrade sicher durchführen

Nach der Installation neuer Module oder Magento-Updates müssen Datenbankschema und -daten migriert werden. Der Befehl php bin/magento setup:upgrade ist dabei einer der wichtigsten Magento CLI Befehle überhaupt. Er überprüft alle installierten Module auf ausstehende Datenbankmigrationen, führt diese durch und aktualisiert die Modulversionen in der Datenbank.

Der Setup-Upgrade-Befehl sollte nach jeder Modulinstallation, -aktualisierung oder Magento-Core-Aktualisierung ausgeführt werden. Er ist in den meisten Deployment-Prozessen fest verankert und läuft nach dem Composer-Update. Wichtig zu wissen: In Produktionsumgebungen kann setup:upgrade je nach Datenbankgröße und Anzahl der Migrationen erhebliche Zeit in Anspruch nehmen. Plane diesen Schritt daher in dein Maintenance-Window ein.

Für Entwickler ist darüber hinaus der Befehl php bin/magento setup:db:status interessant. Er zeigt an, ob es ausstehende Datenbankmigrationen gibt, ohne diese tatsächlich durchzuführen. So kannst du schnell prüfen, ob ein setup:upgrade notwendig ist, bevor du den eigentlichen Upgrade-Prozess anstößt.

Cronjobs in Magento 2 per CLI verwalten

Magento 2 setzt intensiv auf Cronjobs für Hintergrundprozesse wie E-Mail-Versand, Katalog-Aktualisierungen, Preisregeln und vieles mehr. Die Magento CLI bietet verschiedene Befehle, um Cronjobs zu starten, zu überprüfen und zu debuggen.

Mit php bin/magento cron:run werden alle fälligen Cron-Aufgaben ausgeführt. Dieser Befehl ist der Dreh- und Angelpunkt der Magento-Hintergrundverarbeitung. In Produktionsumgebungen wird er typischerweise alle Minute durch einen System-Cronjob aufgerufen. In Entwicklungsumgebungen kannst du ihn manuell triggern, um zu testen, ob deine Cron-Implementierungen korrekt funktionieren.

Für das Debugging von Cron-Problemen ist php bin/magento cron:status ein wertvoller Helfer. Er zeigt dir alle geplanten und laufenden Cron-Jobs mit ihrem Status. Hängende oder fehlgeschlagene Jobs lassen sich so schnell identifizieren. Mit php bin/magento cron:install wird die Magento-Cron-Konfiguration in die System-Crontab eingetragen – ein einmaliger Schritt bei der Ersteinrichtung eines Magento-Systems.

Wartungsmodus und System-Informationen professionell nutzen

Der Wartungsmodus ist ein unverzichtbares Werkzeug für Deployments und Wartungsarbeiten. Mit php bin/magento maintenance:enable versetzt du den Shop in den Maintenance-Modus, sodass Besucher eine entsprechende Hinweisseite sehen, während du Arbeiten am System durchführst. Mit php bin/magento maintenance:disable wird der Wartungsmodus wieder deaktiviert.

Eine besonders praktische Funktion ist die Möglichkeit, IP-Adressen vom Wartungsmodus auszunehmen. Mit dem Parameter --ip kannst du bestimmte IP-Adressen angeben, für die der Shop trotz aktivem Wartungsmodus normal erreichbar ist. Das ermöglicht es dir und deinem Team, die Änderungen in der Produktivumgebung zu testen, bevor alle anderen Nutzer wieder Zugang erhalten.

Für einen schnellen Überblick über das installierte Magento-System bietet die CLI ebenfalls hilfreiche Befehle. Mit php bin/magento --version erfährst du die aktuelle Magento-Version. Der Befehl php bin/magento info:currency:list zeigt alle verfügbaren Währungen, php bin/magento info:language:list alle installierten Sprachen und php bin/magento info:timezone:list alle Zeitzonen. Diese Informationen sind besonders bei Systemmigrationen und Debugging-Szenarien hilfreich.

Sicherheitsaspekte und Best Practices bei der Nutzung der Magento CLI

Die Magento CLI ist ein mächtiges Werkzeug – und mit großer Macht kommt große Verantwortung. Im Produktivbetrieb sollte der Zugriff auf die CLI streng reglementiert sein. Nur autorisierte Benutzer mit den notwendigen Systemrechten sollten Magento CLI Befehle auf dem Produktionsserver ausführen dürfen.

Ein häufiger Fehler ist das Ausführen von CLI-Befehlen als Root-Benutzer. Das kann zu falschen Dateibeständen führen, bei denen der Webserver-User keine Schreibrechte mehr hat. Nutze immer den Webserver-Benutzer oder einen dedizierten Deploy-User mit den minimal notwendigen Rechten. In Docker-basierten Umgebungen ist das durch die Container-Architektur oft automatisch geregelt, sollte aber dennoch explizit konfiguriert werden.

Für Produktionsumgebungen empfiehlt sich der Einsatz von Deployment-Tools wie Deployer, Capistrano oder ähnlichen Lösungen, die die CLI-Befehle in der richtigen Reihenfolge und mit den korrekten Benutzerrechten ausführen. Diese Tools ermöglichen auch Zero-Downtime-Deployments, bei denen der Shop während des gesamten Deployment-Prozesses für Besucher verfügbar bleibt.

Logge wichtige CLI-Operationen in Produktionsumgebungen. Insbesondere Setup-Upgrade, DI-Compile und Static-Content-Deploy sollten protokolliert werden, um im Fehlerfall nachvollziehen zu können, was wann ausgeführt wurde. Viele Deployment-Tools bieten diese Funktionalität von Haus aus, alternativ lässt sich jeder Befehl mit einer einfachen Umleitung in eine Logdatei ergänzen.

Magento CLI in modernen CI/CD-Pipelines einsetzen

Moderne Magento-Entwicklung ist ohne automatisierte Deployment-Pipelines kaum denkbar. GitLab CI/CD, GitHub Actions, Jenkins und ähnliche Tools haben den Deployment-Prozess revolutioniert und machen manuelle Deploys auf dem Server weitgehend überflüssig. Die Magento CLI-Befehle sind dabei das Herzstück jeder Deployment-Stage.

Eine typische CI/CD-Pipeline für Magento umfasst mehrere Stages: Im Build-Stage werden Composer-Abhängigkeiten installiert, DI-Compilation und Static-Content-Deploy ausgeführt. Im Test-Stage laufen Unit- und Integration-Tests. Im Deploy-Stage werden die gebauten Artefakte auf den Zielserver übertragen und dort mit weiteren Magento CLI Befehlen – Setup-Upgrade, Cache-Flush, Indexer-Reset – finalisiert.

Dabei spielt auch die Hyvä-spezifische Besonderheit eine Rolle: In der Pipeline muss vor dem Magento-Build der Hyvä-Build-Prozess mit NPM/Node stattfinden, da die kompilierten CSS-Dateien von Hyvä als Teil des Static-Content-Deploys ausgeliefert werden. Eine gut strukturierte CI/CD-Pipeline berücksichtigt diese Abhängigkeiten und führt alle Schritte in der korrekten Reihenfolge aus.

Die Nutzung von Umgebungsvariablen in Kombination mit php bin/magento config:set ermöglicht es, umgebungsspezifische Konfigurationen automatisch zu setzen. So können API-Keys, Bezahldienstleister-Konfigurationen und andere sensitive Daten sicher in der CI/CD-Umgebung gespeichert und während des Deployments automatisch in Magento übertragen werden, ohne dass diese sensiblen Daten im Code-Repository landen.

Eigene Magento CLI Commands entwickeln

Eine der leistungsstärksten Funktionen der Magento CLI ist die Möglichkeit, eigene Commands zu implementieren. Jedes Magento-Modul kann eigene CLI-Befehle registrieren, die dann genauso wie die Core-Befehle über php bin/magento aufgerufen werden können. Das eröffnet nahezu unbegrenzte Möglichkeiten für Automatisierungen und Batch-Verarbeitungen.

Ein eigener Magento CLI Command ist eine PHP-Klasse, die von der Symfony Console Component erbt. Magento nutzt die Symfony Console als Unterbau für die gesamte CLI-Infrastruktur. In deiner Klasse definierst du den Befehlsnamen, eine Beschreibung, mögliche Argumente und Optionen sowie die eigentliche Ausführungslogik in der execute()-Methode. Die Registrierung erfolgt über die di.xml-Konfiguration deines Moduls.

Praktische Einsatzgebiete für eigene CLI Commands sind vielfältig: Datenmigrationen zwischen Systemen, das Bereinigen veralteter Datenbankeinträge, das automatisierte Versenden von Reports, die Integration mit externen APIs oder das Anlegen von Testdaten für Entwicklungsumgebungen. Eigene CLI-Befehle sind dabei wesentlich performanter als entsprechende Admin-Panel-Funktionen, da sie ohne HTTP-Overhead und Session-Management auskommen.

Fazit: Die Magento CLI als täglicher Begleiter

Die Magento CLI Befehle sind weit mehr als nur ein technisches Hilfsmittel – sie sind der Schlüssel zu einer professionellen und effizienten Magento-Entwicklung. Wer die wichtigsten Magento 2 Commands kennt und versteht, in welchem Kontext er sie einsetzen sollte, wird deutlich produktiver arbeiten und Fehler in kürzerer Zeit identifizieren und beheben können.

Von der einfachen Cache-Verwaltung über komplexe Deployment-Prozesse bis hin zur Entwicklung eigener Commands bietet die Magento CLI ein beeindruckendes Spektrum an Möglichkeiten. Kombiniert mit modernen Entwicklungswerkzeugen wie CI/CD-Pipelines, Hyvä-Themes und Cloud-Hosting-Lösungen wird die CLI zum zentralen Steuerelement für den gesamten Magento-Lifecycle.

Investiere Zeit in das tiefe Verständnis der Magento CLI – es lohnt sich. Jeder Befehl, den du verstehst und sicher einsetzen kannst, macht dich zu einem besseren Magento-Entwickler und deinen Shop zu einem robusteren, besser wartbaren System. Die CLI ist nicht das letzte Mittel, wenn etwas nicht funktioniert – sie ist das erste Werkzeug, das du bei der täglichen Arbeit greifen solltest.