Konsole
- Einführung
- Aufruf der Konsole
- Hilfe
- Anwendungsbeispiele
- Entwicklung eigener Konsolen-Skripte
- Integration der Konsole in Phpstorm
- Tipps
Einführung
REDAXO liefert mehrere CLI ("Command-line interface")-Befehle und Dienstprogramme, die über die Konsole (console) ausgeführt werden können. Sie ermöglichen es u.a. REDAXO zu installieren, AddOns zu aktualisieren und den Entwicklungsprozess sowie Wartungsarbeiten zu beschleunigen. AddOns oder PlugIns können den Funktionsumfang der Konsole um weiteren Befehle erweitern.
Mögliche Einsatzzwecke:
- REDAXO Installation
- AddOn-Installation / Deinstallation
- Schnittstelle für erweitere/spezielle Funktionen/Vorgänge
- Automatisierung/Scripting von Abläufen mit Zugriff auf das System
- Umgebung um sehr aufwändige Prozesse wie Migrationen, Report-Generierung o.ä. ablaufen zu lassen, ohne Timeouts etc.
- Fernwartung des Systems
- automatisierte Veröffentlichungsprozesse der Entwicklungsstände von Websites (Deploy-Workflows)
- via AddOns erweiterbar (Befehle registrierbar, siehe untenstehendes Beispiel)
Im Rahmen einer REDAXOHour ist eine Videoeinführung entstanden, die viele Punkte dieses Kapitels erklärt.
Aufruf der Konsole
php redaxo/bin/console
oder
redaxo/bin/console
(Hierbei sollte die Datei console
ausführbar sein)
Je nach System ist es ggf. erforderlich, die Konsole unter dem PHP-User bzw. Eigentümer des Webordners auszuführen. In diesem Fall lautet der Befehl:
sudo -u username php redaxo/bin/console
Für Docker exec sollte man -u username
an den Befehl anfügen.
Hilfe
Der einfache Aufruf der Konsole per console
ohne Parameter liefert eine Liste aller
aktuell verfügbaren Konsolen-Befehle.
Um mehr Informationen und Optionen zum jeweiligen Befehl zu erhalten, fügt man dem Aufruf des Kommandos --help
als Parameter an.
z. B.: console cache:clear --help
Anwendungsbeispiele
Passwort setzen
Durch den Zugriff via REDAXO Konsole können für Backend-Benutzer neue Passwörter gesetzt werden. Dies ist insbesondere dann hilfreich, wenn kein Admin-Zugriff via Backend mehr möglich ist.
php redaxo/bin/console user:set-password <username> <passwort>
Datenbank Backup erzeugen/zurückspielen
Da in der Konsole in der Regel weniger Restriktionen gegeben sind, können umfangreiche Datenbanksicherungen erstellt oder wiederhergestellt werden. Speziell für große Datenbanken ist dies ein effizienter Weg zur Sicherung.
Erzeugt eine Sicherung in der Datei dump.sql
php redaxo/bin/console db:connection-options | xargs mysqldump > dump.sql
Wiedereinspielen einer vorher erstellten Sicherung aus der Datei dump.sql
.
In der Datenbank enthaltene Tabellen und Daten werden dabei überschrieben!
php redaxo/bin/console db:connection-options | xargs sh -c 'mysql "$0" "$@" < dump.sql'
Core/AddOn/PlugIn Assets synchronisieren
Um die Entwicklung von AddOns und PlugIns zu erleichtern, ist es möglich Dateien zwischen dem öffentlich zugänglichen assets/
Ordner und den AddOn/PlugIn Quellen unter redaxo/src/addons
zu synchronisieren. Derzeit ist keine Enschränkung auf einzelne Ordner vorgesehen.
Die Synchronisierung erfolgt in der Reihenfolge:
- Synchronisierung
Existiert die Datei/Verzeichnis nur in assets/
oder ist neuer als in redaxo/src/core/
bzw. redaxo/src/addons/
wird alles von assets/
nach redaxo/src/core/
bzw. redaxo/src/addons/
kopiert.
- Synchronisierung
Existiert die Datei/Verzeichnis nur in redaxo/src/core/
bzw. redaxo/src/addons/
oder ist neuer als in assets/
wird alles von redaxo/src/core/
bzw. redaxo/src/addons/
nach assets/
kopiert.
php redaxo/bin/console assets:sync
Datenbankschema als PHP exportieren
Bei der Entwicklung von AddOns und PlugIns ist es beim Verwenden von Datenbank-Tabellen notwendig, diese bei der Installation des AddOns/PlugIns anzulegen. Dafür bietet REDAXO eine Schema API, die es erlaubt Tabellen zu erzeugen und zu migrieren.
Der dafür notwendige PHP Code lässt sich mittels Konsolen-Befehl erzeugen, um Ihn anschließend in die install.php
zu kopieren.
php redaxo/bin/console db:dump-schema <tabellenname>
package:list
package:list
Liefert Informationen über installierte AddOns
Optionen:
- search: filtert die Liste nach dem Suchbegriff
- installed-only (-i): zeigt nur installierte Packages an
- activated-only (-a): zeigt nur installierte & aktivierte Packages an
- using-exit-code: gibt je nachdem, ob es zu den ausgewählten Filtern ein Ergebnis gibt,
0
oder1
als exit-code zurück (hilfreich bei Skripten) - json: liefert anstelle einer formatierten Tabelle ein JSON mit Packages.
install:list
install:list
Listet alle verfügbaren Addons von redaxo.org auf und zeigt die installierte Version dazu an.
Optionen:
--search
- Filtert die Liste anhand eines Suchbegriffs (vgl. Filterung/Suche im Backend)--updates-only
- Zeigt nur AddOns an, für die ein Update verfügbar ist--json
- gibt die Ausgabe als JSON (für z.B. Verarbeitung in Skripten)
Entwicklung eigener Konsolen-Skripte
run.php
Die Ausführung eines Konsolen-Befehls erfordert eine eigene Klasse, die auf rex_console_command
aufbaut und den ausführbaren Code selbst enthält bzw. aufruft. In dieser Klasse muss es eine Methode execute
geben. Die einfachste Form sieht etwa so aus:
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
class mein_console_befehl extends rex_console_command {
protected function execute(InputInterface $input, OutputInterface $output): int
echo "hallo redaxo"; // beliebiges php hier
return 0;
}
}
Falls die implementierte Funktionalität sowohl via Weboberfläche als auch REDAXO Konsole zugreifbar sein sollte, würde es sich anbieten, die entsprechende Logik in einer separaten PHP Klasse zu implementieren und diese aus der o.g. Klasse heraus aufzurufen.
package.yml
Damit der ausführbare Befehl in der REDAXO Konsole zugänglich ist, muss er noch in der package.yml eines AddOns als solcher definiert werden.
Beispiel
console_commands:
meinaufruf:befehl: mein_console_befehl
Integration der Konsole in Phpstorm
Da die REDAXO Konsole auf der symfony/console
Bibliothek aufsetzt, kann die REDAXO Konsole wie eine herkömmliche Symfony-Console mit Phpstorm integriert werden.
Dies ist möglich, sobald das REDAXO-Setup abgeschlossen wurde.
Tipps
Autovervollständigung
Um die Bedienbarkeit der Konsole zu verbessern, ist es möglich ein Autovervollständigung-Skript zu verwenden, dass auf der Konsole durch doppeltes Drücken der Tab-Taste ausgelöst wird.
Artikel bearbeiten