Grav — CLI für das Flat-File-CMS Grav

Grav ist ein modernes Flat-File-CMS auf PHP-Basis: Es kommt ganz ohne Datenbank aus und speichert deine Inhalte als einfache Markdown- und YAML-Dateien direkt im Dateisystem. Die Verwaltung läuft über zwei Kommandozeilen-Werkzeuge – bin/grav für Kernaufgaben wie Cache leeren, Backups und den Scheduler sowie bin/gpm, den Grav Package Manager, mit dem du Plugins und Themes installierst und aktuell hältst. Dieser Guide zeigt dir die wichtigsten Befehle beider Tools für den Alltag, von der Cache-Pflege bis zum Core-Upgrade.

bin/grav — Allgemein

bin/grav list — Listet alle verfügbaren Grav-CLI-Kommandos auf.

bin/grav list

bin/grav help <command> — Zeigt die Hilfe zu einem bestimmten Kommando an.

bin/grav help clear-cache

bin/grav new-project <path> — Erstellt ein neues Grav-Projekt in einem Verzeichnis.

bin/grav new-project ~/sites/my-grav-site

bin/grav sandbox — Erstellt eine über Symlinks verbundene Sandbox-Kopie von Grav (für die Entwicklung).

bin/grav sandbox -s ~/grav-core ~/sites/my-sandbox

bin/grav — Cache & Aufräumen

bin/grav clear-cache — Leert den Grav-Cache.

bin/grav clear-cache

bin/grav clear-cache --all — Leert alle Cache-Typen (Standard + Bilder + Assets).

bin/grav clear-cache --all

bin/grav clear-cache --assets-only — Leert nur den Cache der kompilierten Assets (CSS-/JS-Pipeline).

bin/grav clear-cache --assets-only

bin/grav clear-cache --images-only — Leert nur den Bilder-Cache (generierte Thumbnails).

bin/grav clear-cache --images-only

bin/grav clear-cache --tmp-only — Leert nur die temporären Dateien.

bin/grav clear-cache --tmp-only

bin/grav clean — Entfernt unnötige Dateien (Vendor-Ballast, Tests, Doku).

bin/grav clean

bin/grav — Backup & Sicherheit

bin/grav backup — Erstellt ein vollständiges Backup der Grav-Site.

bin/grav backup

bin/grav backup --destination <path> — Erstellt ein Backup in einem bestimmten Verzeichnis.

bin/grav backup --destination ~/backups

bin/grav security — Führt einen Sicherheits-Scan der Grav-Installation durch.

bin/grav security

bin/grav logviewer — Zeigt Grav-Log-Einträge auf der Kommandozeile an.

bin/grav logviewer

bin/grav — Scheduler & Composer

bin/grav scheduler -i — Installiert den Cron-Job für den Grav-Scheduler.

bin/grav scheduler -i

bin/grav scheduler -r — Entfernt den Cron-Job für den Grav-Scheduler.

bin/grav scheduler -r

bin/grav scheduler — Führt anstehende geplante Aufgaben manuell aus.

bin/grav scheduler

bin/grav composer — Führt Composer im Grav-Kontext aus.

bin/grav composer update

bin/grav yamllinter — Prüft alle YAML-Dateien auf Syntaxfehler.

bin/grav yamllinter

bin/gpm — Paket-Infos

bin/gpm index — Listet alle im Repository verfügbaren Plugins und Themes auf.

bin/gpm index

bin/gpm index --plugins — Listet nur die verfügbaren Plugins auf.

bin/gpm index --plugins

bin/gpm index --themes — Listet nur die verfügbaren Themes auf.

bin/gpm index --themes

bin/gpm info <package> — Zeigt detaillierte Infos zu einem Plugin oder Theme an.

bin/gpm info admin

bin/gpm version — Zeigt die Versionen von Grav und der Plugins an.

bin/gpm version

bin/gpm — Installieren & Deinstallieren

bin/gpm install <package> — Installiert ein Plugin oder Theme.

bin/gpm install admin

bin/gpm install <pkg1> <pkg2> — Installiert mehrere Pakete auf einmal.

bin/gpm install admin login sitemap

bin/gpm install --all-yes <package> — Installiert ohne Bestätigungsabfragen.

bin/gpm install --all-yes feed

bin/gpm uninstall <package> — Deinstalliert ein Plugin oder Theme.

bin/gpm uninstall simplesearch

bin/gpm — Aktualisieren

bin/gpm update — Prüft auf Updates für Plugins/Themes und installiert sie.

bin/gpm update

bin/gpm update <package> — Aktualisiert ein bestimmtes Plugin oder Theme.

bin/gpm update admin

bin/gpm update --plugins — Aktualisiert nur die Plugins.

bin/gpm update --plugins

bin/gpm update --themes — Aktualisiert nur die Themes.

bin/gpm update --themes

bin/gpm self-upgrade — Aktualisiert den Grav-Core auf die neueste Version.

bin/gpm self-upgrade

bin/gpm self-upgrade -f — Erzwingt ein Core-Upgrade (Neu-Download, auch wenn aktuell).

bin/gpm self-upgrade -f

Fazit

Mit bin/grav und bin/gpm verwaltest du eine komplette Grav-Installation allein von der Kommandozeile aus – ganz ohne Datenbank-Backend, weil Grav alle Inhalte als Dateien ablegt. Zieh dir vor jedem Plugin-, Theme- oder Core-Update mit bin/grav backup einen vollständigen Schnappschuss, dann lässt sich ein fehlgeschlagenes bin/gpm update oder self-upgrade jederzeit zurückrollen. Achte außerdem auf korrekte Dateirechte: Der Webserver-Benutzer braucht Schreibzugriff auf cache/, logs/, backup/ und user/, sollte aber nicht das ganze Verzeichnis besitzen. So bleibt deine Site aktuell und sicher.

Weiterführende Links

Grav-Dokumentation – offizielles Handbuch zu CLI, Plugins und Themes (englisch)
getgrav.org – Projektseite mit Download und Plugin-/Theme-Verzeichnis (englisch)
GPM – Grav Package Manager – Referenz zu allen bin/gpm-Kommandos (englisch)