1. Die wichtigste Regel im Projekt

Der wichtigste Punkt in diesem Projekt steht ganz am Anfang: Verwende nicht direkt php bin/magento, sondern die Wrapper im bin/-Verzeichnis. Genau das macht die Befehle im Docker-Setup konsistent. Ein guter Magento CLI Befehle-Workflow beginnt also nicht mit dem Magento-Kernbefehl, sondern mit der korrekten Projektumgebung.

Das ist kein Stilthema, sondern eine praktische Regel. Die Wrapper kümmern sich um den richtigen Container-Kontext und reduzieren Inkonsistenzen zwischen Host und Container. Wenn mehrere Entwickler an derselben Codebasis arbeiten, verhindert das eine Menge unnötiger Unterschiede. Gerade bei Magento mit Docker-Setup spart diese Disziplin spürbar Zeit.

2. Magento-Befehle für Alltag und Setup

Die erste Gruppe unverzichtbarer Magento CLI Befehle betrifft das eigentliche Magento-System. Das sind Befehle, die du bei Modul-Entwicklung, Setup-Änderungen, Konfigurationsanpassungen oder täglichen Wartungsschritten ständig brauchst. Statt alle theoretisch möglichen CLI-Optionen aufzulisten, ist der Fokus hier auf die Kommandos gelegt, die im Alltag wirklich tragen.

# 1. Magento command wrapper
bin/magento

# 2. Module and schema updates
bin/magento setup:upgrade

# 3. Cache status
bin/magento cache:status

# 4. Cache flush
bin/magento cache:flush

# 5. Static content deploy
bin/magento setup:static-content:deploy de_DE -t Mironsoft/default -f

# 6. Indexer status
bin/magento indexer:status

# 7. Reindex
bin/magento indexer:reindex

# 8. Cron run
bin/magento cron:run

setup:upgrade ist der klassische Einstieg nach Moduländerungen, besonders bei module.xml, deklarativem Schema, Data Patches oder neuen Konfigurationen. cache:status und cache:flush sind unverzichtbar, wenn Änderungen scheinbar „nicht ankommen“. Reindexing wird relevant, sobald Produktdaten, Preisregeln, Lager oder Suchindizes berührt werden. Diese Befehle bilden das Rückgrat für viele normale Entwicklungszyklen.

Auch cron:run ist im Alltag nützlich, wenn du Prozesse testest, die nicht direkt über Request oder CLI starten, sondern über Magentos geplante Jobs laufen. Wer mit Queues, Importen, periodischen Aufgaben oder Benachrichtigungen arbeitet, braucht diesen Befehl schnell häufiger als gedacht.

3. Cache, Static Content und Dateisystem

Die zweite Gruppe von Magento CLI Befehle betrifft Cache, Build und das Dateisystem. Gerade im Hyvä- oder Theme-Kontext ist es wichtig zu verstehen, wann du nur Cache leeren musst und wann du tatsächlich statische Dateien neu erzeugen solltest. Viele vermeintliche Magento-Fehler sind in Wahrheit nur alte Assets oder veraltete View-Dateien.

# 9. Hyva-friendly cache clean
bin/cache-clean

# 10. Fix ownership
bin/fixowns

# 11. Fix permissions
bin/fixperms

# 12. Restart containers
bin/restart

# 13. Build Tailwind assets
bin/npm --prefix app/design/frontend/Mironsoft/default/web/tailwind run build

bin/cache-clean ist im täglichen Frontend- und Konfigurationsworkflow oft angenehmer als ein vollständiges Flush, weil gezielter gearbeitet werden kann. bin/fixowns und bin/fixperms helfen, wenn Container und Host Dateirechte unterschiedlich gesetzt haben. Das passiert in Docker-Setups häufiger, als man denkt, besonders nach Generatoren, Composer-Läufen oder manuellen Dateioperationen.

Der Tailwind-Build gehört in diesem Projekt ebenfalls in die unverzichtbare Gruppe, weil Theme-Änderungen ohne ihn im Frontend oft nicht sichtbar sind. Für echte Deployments bleibt die Reihenfolge entscheidend: CSS bauen, statische Dateien löschen, Static Content deployen, Cache leeren. Wer diesen Ablauf ignoriert, debuggt oft an den falschen Stellen.

4. Analyse, Composer und Debugging

Ein robuster Workflow endet nicht bei Magento selbst. Zu den wichtigsten Magento CLI Befehle gehören auch die für statische Analyse, Package-Management und Debugging. Gerade bei Magento lohnt sich das, weil viele Fehler erst über PHPStan, PHPCS oder gezielte Xdebug-Sessions sauber sichtbar werden.

# 14. PHPStan / analysis
bin/analyse

# 15. PHPCS
bin/phpcs

# 16. PHPCBF
bin/phpcbf

# 17. Composer
bin/composer

# 18. Enable Xdebug
bin/xdebug enable

# 19. Enable CLI debugging
bin/debug-cli enable

bin/analyse ist besonders wertvoll bei neuen Modulen, Repositories, ViewModels und API-Schichten. PHPCS und PHPCBF helfen, wenn das Projekt Coding-Standards konsistent halten soll. bin/composer bleibt der einzige richtige Weg für Paketoperationen im Containerkontext. Wer Composer direkt lokal und parallel im Container benutzt, schafft sich schnell reproduzierbare Probleme.

Debugging über Xdebug oder CLI-Debugging ist dann wichtig, wenn ein Fehler nicht mehr nur über Logs oder Code-Inspektion nachvollziehbar ist. Gerade bei Setup-Prozessen, Queue-Consumern, Cronjobs oder Magento-internen Service-Ketten spart aktives Debugging oft deutlich mehr Zeit als weitere Vermutungen.

5. Datenbank, Logs und Shell

Die letzte Gruppe unverzichtbarer Magento CLI Befehle betrifft Datenbank, Logs und Shell-Zugriff. Diese Werkzeuge sind nicht nur für Notfälle da. Sie gehören in den normalen Diagnose- und Wartungsfluss. Wer Magento entwickelt, sollte nicht ausschließlich aus dem Browser heraus arbeiten.

# 20. MySQL shell
bin/mysql

# 21. Database dump
bin/mysqldump

# 22. Log viewer
bin/log exception.log

# 23. Container shell
bin/bash

# 24. One-off CLI command
bin/cli php -v

bin/mysql hilft beim Prüfen von Datenständen, Quotes, Queue-Tabellen oder Konfigurationswerten. bin/mysqldump gehört zu den wichtigen Sicherheitsnetzen vor riskanteren Arbeiten. bin/log ist für schnelle Diagnose im Exception- oder System-Log oft der direkte Einstiegspunkt. bin/bash und bin/cli sind dann nützlich, wenn du innerhalb des Containers gezielt etwas prüfen willst, ohne das Setup zu verlassen.

Auch wenn der Titel von 20 Befehlen spricht, ist die eigentliche Idee wichtiger als die Zahl: Ein guter Workflow gruppiert Kommandos nach Zweck. Setup, Cache, Analyse, Datenbank und Debugging bilden gemeinsam die praktische Arbeitsbasis. Genau aus dieser Basis entsteht Geschwindigkeit, nicht aus einer langen unstrukturierten Befehlssammlung.

6. Typische Fehler bei CLI-Workflows

Die häufigsten Fehler sind erstaunlich wiederholbar. Erstens werden Wrapper umgangen und Befehle direkt lokal ausgeführt. Zweitens wird zu schnell ein kompletter Cache Flush gemacht, statt die eigentliche Ursache zu verstehen. Drittens werden Theme-Änderungen getestet, ohne Tailwind oder Static Content korrekt neu aufzubauen. Viertens werden Rechteprobleme übersehen. Fünftens fehlt statische Analyse, bis Fehler bereits in Laufzeitpfaden sichtbar werden.

Ein weiterer Fehler ist, CLI-Befehle nur reaktiv zu sehen. In guten Teams sind sie Teil eines klaren Diagnosemusters. Wenn eine Änderung nicht sichtbar ist, prüft man Build, Cache, Static Content und Dateirechte. Wenn ein Prozess nicht läuft, prüft man Queue, Cron, Logs und Konfiguration. Wenn Architekturfragen offen sind, nutzt man Analyse und Debugging. Genau dadurch werden Magento CLI Befehle zu Werkzeugen und nicht nur zu Rettungsankern im Krisenfall.

Ebenso hilfreich ist eine feste Reihenfolge für Deploy- oder Diagnosefälle. Nach Theme-Anpassungen prüfst du zuerst den Asset-Build, dann statische Dateien und schließlich den Cache. Nach Moduländerungen prüfst du Setup, generierte Konfiguration und Logs. Nach Integrationsfehlern prüfst du Queue, Cron, Datenbankzustände und Exceptions. Diese Reihenfolge ist oft wertvoller als ein weiterer neuer Befehl, weil sie aus einzelnen Kommandos einen reproduzierbaren Arbeitsablauf macht.

7. Wrapper vs. rohe Container-Befehle

Im Mark-Shust-Setup ist der Unterschied zwischen Wrappern und rohen Container-Befehlen nicht akademisch. Die Wrapper standardisieren den Projektzugriff. Eine saubere Liste von Magento CLI Befehle im Team sollte deshalb immer von den Wrappern ausgehen und nicht von individuellen Shell-Gewohnheiten.

Für normale Projektarbeit ist die Entscheidung daher klar: Wrapper zuerst. Nur wenn ein Sonderfall wirklich nicht über die vorgesehenen Skripte lösbar ist, sollte man eine bewusstere Container-Ebene betreten. Und auch dann bleibt es besser, diese Ausnahme gezielt zu dokumentieren.

9. Zusammenfassung

Die wichtigsten Magento CLI Befehle sind nicht einfach eine Liste technischer Optionen, sondern ein Arbeitsmodell. Wer Wrapper, Cache-Prozesse, Analyse, Build und Debugging sauber beherrscht, arbeitet in Magento deutlich stabiler und schneller.

Im Mark-Shust-Setup ist der zentrale Punkt klar: immer die Wrapper im bin/-Verzeichnis verwenden. Daraus entsteht ein reproduzierbarer Workflow für Magento, Composer, Logs, Datenbank und Deployment. Genau diese Konsistenz spart im Alltag die meiste Zeit.

10. FAQ: CLI-Befehle für Magento-Entwickler