ConcreteCMS über die Kommandozeile verwalten

Die Kommandozeile hilft bei Wartung, Diagnose und Entwicklung. Sie verwendet dieselbe ConcreteCMS-Installation wie der Browser, kann bei einem falschen Arbeitsordner aber eine andere Datenbank betreffen. Beginnen Sie deshalb mit Befehlen, die nur Informationen anzeigen.

Die richtige Installation auswählen

  1. Wechseln Sie in das Stammverzeichnis der gewünschten ConcreteCMS-Installation.
  2. Verwenden Sie die PHP-Version dieser Installation und rufen Sie concrete/bin/concrete list auf.
  3. Lesen Sie mit --help die Optionen des Befehls, den Sie anschließend verwenden wollen.
php concrete/bin/concrete list
php concrete/bin/concrete c5:info
php concrete/bin/concrete c5:compare-schema --help

list zeigt die in dieser Installation verfügbaren Befehle. c5:info zeigt Details zur Installation. Der Aufruf mit --help liest nur die Hilfe zu c5:compare-schema; er verändert kein Schema. Prüfen Sie vor weiteren Befehlen, ob Arbeitsverzeichnis, PHP-Version und Datenbank zur beabsichtigten Website gehören.

ConcreteCMS 9.5.7 stellt außerdem unter anderem c5:is-installed, c5:clear-cache, c5:package:update, c5:exec, c5:job und concrete:scheduler:run bereit. Pakete können weitere Befehle hinzufügen. Geben Sie keine Zugangsdaten in ein Shell-Protokoll oder öffentliches Repository ein.

Die Verwaltung zeigt Aufgaben, deren Zeitplan serverseitig ausgeführt werden kann.

Abbildung 1: Registrierte Aufgaben in der Verwaltung werden erst über den Scheduler nach Zeitplan ausgeführt.

Aufgaben und Einzelbefehle unterscheiden

concrete:scheduler:run verarbeitet fällige Aufgaben. Ein regelmäßiger Serveraufruf muss den Scheduler starten; ein einmaliger manueller Lauf richtet noch keinen Zeitplan ein. Kontrollieren Sie unter Verwaltung → System & Einstellungen → Automatisierung → Aufgaben, welche Aufgaben registriert sind und ob letzte Läufe Fehler melden. Aufgaben regelmäßig ausführen erklärt die Einrichtung.

c5:job führt ältere Aufträge aus. Eine Umstellung von einem Auftrag auf eine Aufgabe erfordert die Anpassung der Funktion und ihres Zeitplans; ein anderer Befehlsname allein reicht nicht.

c5:exec lädt ein PHP-Skript innerhalb der ConcreteCMS-Umgebung. Nutzen Sie es für einen kontrollierten einmaligen Lauf nur, wenn Sie Zielinstallation, Berechtigungen und Inhaltsfolgen kennen. Erstellen Sie vorher eine Sicherung und lassen Sie das Skript vor Schreibvorgängen stoppen, falls Core-Version oder Ausgangsdaten abweichen.

Schreibende Befehle absichern

Achtung: Installationen, Updates, Migrationen und Bereinigungen können Daten dauerhaft ändern. Sichern Sie vor einem solchen Befehl Datenbank und Anwendungsdateien zusammen. Lesen Sie seine Hilfe und testen Sie ihn auf einer Kopie.

Kontrollieren Sie die Zielinstallation mit c5:info. Lesen Sie nach dem Lauf Protokolle und öffnen Sie betroffene Seiten im Browser. Wenn ein Installationsbefehl mit Timeout endet, klären Sie zuerst, welche Tabellen und Dateien bereits angelegt wurden. Starten Sie ihn nicht blind erneut.

Weiterlesen

Quelle: Concrete CMS Dokumentation (EN) · Stand: ConcreteCMS 9.5.7