„Never change a running system?“ – Wer kennt diesen Spruch nicht. Doch manchmal kommt der Punkt, an dem ein Update nicht nur ratsam, sondern überfällig ist.
Warum auf Grav 2 upgraden?
Die Plattform Grav 1.x hat eine starke Entwicklung durchlaufen und sich bemerkenswert Entwickelt, aber die Plattform Grav 1.x hat jetzt ihren natürlichen Endpunkt der Entwicklung erreicht! Die Entwicklung führten angesichts der Anforderungen zur der ersten Version von Grav 2 und bringt große Neuerungen mit sich.
Admin 2.0 (Moderner SPA-Admin)
- Technologie-Basis: Basiert auf SvelteKit 5, Vite, Tailwind CSS 4 und nutzt das neue Grav-API-Plugin.
- Navigation & Performance: Bietet reibungslose, sofortige Navigation (Single-Page-Anwendung) ohne vollständiges Neuladen sowie asynchrone Hintergrundprozesse (z. B. Indizierung).
- Funktionen & Tools: Integrierter CodeMirror-Editor, Uppy-basierte Medienverarbeitung und gemeinsames Bearbeiten über das neue Sync-Plugin.
- Kompatibilität: Übernimmt bestehende Formularfelder und Vorlagen bei verbesserter UX; durchgehend in TypeScript geschrieben.
Native API
- Grundlage: Stabile Kern-API, die Admin 2.0 antreibt und Headless- sowie entkoppelte Frontends ermöglicht.
- Anwendungsbereiche: CI/CD-Automatisierung, mobile/externe Integrationen und benutzerdefinierte Endpunkte für Plugins.
- Funktion: Verwandelt Grav 2 in ein vollwertiges Headless-CMS.
Modernes PHP & Abhängigkeiten
- Zukunftsfähige Grundlage für jahrelange PHP-Releases
- Saubererer, modernerer PHP-Code im gesamten Kern
Bessere Sicherheit
- Beseitigt Altlasten und CVEs durch moderne Software-Stacks.
- Profitiert von Upstream-Sicherheitsverbesserungen
- aktuellen PHP-Sicherheitspatches
- einem modernen API-Authentifizierungsmodell.
Bessere Leistung
- Profitierte Geschwindigkeitsvorteilen der neuerer PHP- und Symfony-/Twig-Versionen.
- reduziert Seitenaufrufe, während API-gesteuerte Abläufe ressourcenschonender und besser cachebar sind.
Wichtige Voraussetzungen
- PHP-Version: Mindestens PHP 8.3 (PHP 8.4 oder 8.5 werden ebenfalls unterstützt)
- Quellversion: Grav 1.7.50+ oder 1.8.x
- Das Plugin „Migrate to Grav 2.0“ ist die empfohlene Methode, um von Grav 1.7.50+ oder 1.8.x auf Grav 2.0
Wie migriert man?
Um von Grav 1.7.50+ oder 1.8.x auf Grav 2.0 zu wechseln, empfiehlt sich das Plugin „Migrate to Grav 2.0“ zu nutzen. Das Plugin wird auf der bestehenden Website installiert, lädt eine aktuelle Grav‑2.0‑Version herunter und übergibt die Migration an einen eigenständigen, browserbasierten Assistenten, der den verbleibenden Migrationsprozess in einem separaten, sauberen PHP‑Prozess durchführt.
Schritt 1: Backup der Website erstellen
Einfach das in Grav integrierte Backup-Tool: Admin → Tools → Backup nutzen.

Schritt 2: Das Plugin „Migrate to Grav 2.0“ installieren
den Installationsbutton beim Dashboard ausführen oder über die Administration: Plugins → Hinzufügen → Migration zu Grav 2.0 → Installieren.

Schritt 3: Die Migration durchführen
Im Dashboard sollte nun der Button "Start Migration" zusehen sein, ggf. über die Seitenleiste auf „Zu Grav 2.0 migrieren“ und die Schaltfläche „Migration starten“ anklicken.
Solltet ihr folgende Fehlermeldung sehen müsst ihr auf euren Hosting-Anbieter ins Backend wechseln und die PHP Version mind. auf 8.3 stellen.
Ist dies nicht der Fall, könnt ihr mit dem Staging fortfahren und den Installationswizard starten.
Der Assistent entpackt nun die vorbereitete Grav 2.0-Version in ein konfigurierbares Unterverzeichnis (Standardmäßig ist dies der Standardpfad grav-2/)
Als Nächstes geht’s an die eigentliche Arbeit. Euer gesamtes user-Verzeichnis (Seiten, Daten, Konfiguration, Sprachen, Konten, Plugins, Themes, eigene Ordner) wird per Massenkopie in das bereitgestellte Grav‑2.0‑Verzeichnis kopiert. Danach wird die Kompatibilität überprüft, deinstallieren das klassische Admin-Plugin und ersetzen es durch Admin Next.
Der nächste Schritt spiegelt optional admin.die Berechtigungenapi. in den bereitgestellten Konten wider, sodass dieselben Benutzer vom ersten Tag an vollen Zugriff in Admin Next und über die API verfügen.
Damit du nachsehen kannst, ob alles da ist, wo du es erwartest, gibt dir der nächste Schritt eine Übersicht: er zeigt, was im bereitgestellten /user/ Verzeichnis gelandet ist.
im nächsten Step kannst du nun die Migration testen und wenn alles passt zum nächsten Schritt weiterklicken. (Ich persönlich habe hier nicht viel gemacht, einmal kurz die Testinstallation geöffnet, einige Seiten geprüft und bin dann auf continue)
Auf geht es zum Veröffentlichen, der nächste Schritt gibt die 2.0-Inhalte von Grav 2 frei und aktiviert die migrierte Plattform.
Es entfernt die nur für die Testumgebung vorgesehenen Dateien ( migrate.php, .migrating, die bereitgestellte ZIP-Datei) und erstellt ein Backup der alten 1.x-Installation.

Schritt 4: Entfernen Sie das Plugin.
Das Migrations-Plugin ist ein einmaliges Werkzeug und erfüllt nach einer erfolgreichen Migration keinen weiteren Zweck. Entfernt es einfach aus der Plugin-Liste im Adminbereich.
