Der ultimative Drupal-11-Upgrade-Leitfaden: Wichtige Schritte für einen reibungslosen Übergang

Wie man sich auf das Upgrade von Drupal 10 vorbereitet (mit Modulen)

Beginnen Sie mit einem Audit Ihrer aktuellen Drupal-Website. Welche Module sind installiert? Welche sind individuell entwickelt? Werden alle Drittanbieter-Bibliotheken noch unterstützt? Diese Details bestimmen Ihren Upgrade-Pfad. Eine frühzeitige Überprüfung von Performance-Engpässen gibt Ihnen die Möglichkeit, technische Verbesserungen umzusetzen, die Geschwindigkeit und Reaktionsfähigkeit erhöhen.

1. Upgrade Status ausführen

Installieren Sie das Modul Upgrade Status, um veraltete APIs, Kompatibilität von Contrib-Modulen und die Bereitschaft der Umgebung zu erkennen. Dieses Tool scannt Ihre Website, um veralteten Code, inkompatible Module und Umgebungsprobleme zu identifizieren – so erhalten Sie einen klaren Überblick darüber, was vor dem Upgrade auf D11 behoben werden muss.

2. Module und Themes prüfen

Verwenden Sie composer show, um alle installierten Pakete aufzulisten. Gruppieren Sie sie nach:

• Core
• Contrib
• Custom

Markieren Sie Funktionen, die kürzlich nicht aktualisiert wurden oder als nicht unterstützt gelten. Die Kategorisierung Ihres Codebestands hilft dabei, zu erkennen, was aktualisiert, ersetzt oder neu geschrieben werden muss, um mit Version 11 von Drupal kompatibel zu sein. Führen Sie composer outdated aus, um zu sehen, was aktualisiert werden muss. Verwenden Sie composer update, um alles auf die neuesten unterstützten Versionen zu bringen, bevor Sie den Übergang versuchen.

3. Benutzerdefinierten Code überprüfen

Tools wie Drupal Rector helfen dabei, veraltete APIs in benutzerdefinierten Modulen automatisch zu entfernen – das spart viele Stunden manueller Überarbeitung und reduziert Upgrade-Fehler. Führen Sie drupal-check oder PHPStan aus, um veraltete Hooks, APIs oder Basisklassen zu identifizieren. Achten Sie auf entfernte Services in Drupal Version 11.

4. Inhalte und Konfiguration bewerten

Bestandsaufnahme:

• Paragraph-Bundles
• Feldtypen
• Mediennutzung
• Entitätsreferenzen

Bereinigen Sie ungenutzte Bundles und konsolidieren Sie diese, wenn möglich. Die Abbildung von Inhaltstypen, Feldern und Beziehungen verhindert Datenverlust und sorgt für eine reibungslose Migration strukturierter Inhalte und Konfigurationen in die neue Umgebung.

5. Performance-Engpässe prüfen

Analysieren Sie Datenbankabfragen, überprüfen Sie Cron-Jobs und Caching-Strategien (Twig, Render, Dynamic Page Cache). Das Erkennen langsamer Abfragen, Cron-Probleme oder ineffizientem Caching vor dem Upgrade hilft, Ihre Website zu optimieren und Performance-Probleme nicht zu übernehmen.

6. Umgebung sichern

Exportieren Sie die Konfiguration (drush cex), dumpen Sie die Datenbank und archivieren Sie den gesamten Code. Testen Sie die Wiederherstellung lokal vor dem Upgrade. Backups schützen Ihre Daten und Konfiguration – so können Sie die Website bei Upgrade-Fehlschlägen oder kritischen Problemen schnell wiederherstellen.

Sie legen hier das Fundament. Wenn Sie die Vorbereitung überspringen, riskieren Sie Fehler, Ausfälle und Downtime.

Warum jetzt auf das Drupal-11-Major-Release upgraden?

Warten erhöht das Risiko, den Anteil von Altcode und die technische Schuld. Das neue Drupal 11 bringt aktualisierte Abhängigkeiten und vereinfachte APIs. Wenn Sie Drupal 10.3 verwenden, ist das Upgrade inkrementell. Wenn Sie von Drupal 7 migrieren möchten, ist der Abstand groß – aber überwindbar.

Wichtige Vorteile der Drupal-Version 11

• Moderner Stack-Support: PHP 8.3, Symfony 6, Content Editor 5. Alles ist schneller, sicherer und besser gewartet.
• Sauberere APIs: Sie können mit klareren Integrationen und weniger Sonderfallfehlern rechnen.
• Verbesserte Developer Experience (DX), digitale Erlebnisse und User Experience (UX): Es optimiert Backend-Workflows durch Funktionen wie Dependency Injection, typisierte Daten und Autoloading und bietet zugleich schnellere Oberflächen und übersichtlichere Editierwerkzeuge für Content-Teams und Endnutzer.
• Laufender Support: Der Fokus der Community verschiebt sich schnell. Je länger Sie bei älteren Versionen bleiben, desto schwieriger wird es, Unterstützung zu finden.
• Neue Funktionen: Vereinfachte APIs, verbesserte Konfigurations-Workflows, bessere Medienverarbeitung und erweiterte Unterstützung moderner Entwicklungspraktiken machen das System schneller, sauberer und wartungsfreundlicher.
• Single Directory Components: Ein neuer Ansatz für das Frontend-Theming, bei dem Templates, Styles und Skripte pro Komponente in einem Ordner gruppiert werden – für ein übersichtlicheres, modulares Design.
• Site-Builder-freundlich: Mit Tools wie Layout Builder und verbesserter Konfigurationsverwaltung können Site-Builder skalierbare Drupal-Websites erstellen, ohne benutzerdefinierten Code schreiben zu müssen.

Drupal 11 vs. Drupal 10: Wichtige Unterschiede und Neuerungen

Wann sollte das Update von Drupal 10 auf Drupal 11 durchgeführt werden?

Drupal Core 10 erreicht laut drupal.org Mitte/Ende 2026 sein End-of-Life – mit dem Erscheinen von Drupal 12. Deshalb sollten Website-Betreiber jetzt mit der Planung ihres Drupal-11-Upgrades beginnen, um technische Schulden in letzter Minute zu vermeiden, Risiken zu minimieren und auf einer sicheren, unterstützten Plattform zu bleiben. Das Update auf Drupal 11 sollte erfolgen, sobald Ihre Entitäten D11-kompatibel sind. Die meisten Contrib-Module werden aktiv gepflegt und regelmäßig gepatcht. Wenn Ihre Website stabil auf Drupal 10.2+ läuft, wird der Umstieg auf 11 voraussichtlich reibungslos verlaufen.

Tipp: Verwenden Sie Upgrade Status, um die Kompatibilität zu prüfen. Warten Sie nicht bis zum EOL, um in Panik zu geraten.

Wann sollte die Migration von Drupal 7 zu Drupal 11 erfolgen?

Die Antwort lautet: jetzt. Drupal 7 hat bereits sein End-of-Life erreicht – es erhält keine Sicherheitsupdates oder Community-Support mehr. Ihre Website ist dadurch anfällig, veraltet und zunehmend teuer im Unterhalt. Eine Migration von Drupal 7 ist kein Update wie bei D10 zu D11 – es ist ein kompletter Neuaufbau. Core-Module, Themes, selbst Inhaltstypen: nichts lässt sich 1:1 übernehmen. Eine neue Seitenarchitektur muss von Grund auf neu erstellt werden.

Planen Sie mindestens 3–6 Monate Vorlaufzeit ein für:

• Inhaltsmapping
• Neuentwicklung benutzerdefinierter Module
• Umfassende Tests (end-to-end)

Wenn Ihre Website geschäftskritisch ist, verschieben Sie es nicht auf Q4 2025.

→ Mehr dazu: Future-Proof Your Website: Migrating from Drupal 7 to Drupal 11

Drupal-11-Upgrade-Plan

Ein strukturierter Plan senkt Risiken und Kosten. So geht Drupfan bei Kundenprojekten vor:

Content-Migration abbilden

• Identifizieren Sie alle Inhaltstypen, Felder und Taxonomien.
• Entfernen Sie veraltete Inhalte und ungenutzte Strukturen.
• Planen Sie Transformationen, wenn sich Strukturen ändern.

Dokumentation ist entscheidend: Sie müssen wissen, was Sie migrieren, wohin es geht und wie Sie es testen werden.

Website-Umstellung durchführen

• Richten Sie eine saubere Drupal-11-Umgebung ein.
• Portieren oder bauen Sie Ihr Theme neu.
• Erstellen Sie Views und Blöcke bei Bedarf neu.
• Übertragen Sie Konfiguration und Daten in Etappen.
• Führen Sie Regressionstests für alle kritischen Pfade durch.

QA nicht überspringen: Testen Sie mobile Responsivität, Formulare, Suche und Integrationen – und testen Sie dann erneut.

Wichtige Aspekte beim Upgrade von Drupal 10 auf 11

• Custom Code: Was Sie 2015 geschrieben haben, funktioniert 2025 vielleicht nicht mehr. Prüfen, umschreiben oder ausmustern.
• SEO-Auswirkungen: Behalten Sie URL-Strukturen, Metadaten und Redirects bei. Nutzen Sie Redirect und Pathauto frühzeitig.
• Hosting: Prüfen Sie, ob Ihr Hoster PHP 8.3+ und die Systemanforderungen von Drupal 11 unterstützt.
• Editor-Workflows: Bei Umstieg auf Content Editor 5 müssen Content-Teams rechtzeitig geschult werden.
• Contrib-Kompatibilität: Prüfen Sie, ob zentrale Funktionen (z. B. Webform, Paragraphs, Commerce) D11-kompatibel sind – oder finden Sie Alternativen.

Ob Sie Drupal als vollwertiges CMS, headless Backend oder Low-Code-Plattform nutzen, sollte Ihre Migrationsprioritäten bestimmen. Die neueste Hauptversion ist immer wartungsärmer, sicherer und bietet spannende neue Features.

→ Mehr Infos zu wichtigen Aspekten beim Drupal-Upgrade finden Sie in unserem aktuellen Blogartikel.