Jedes Tool, das Sie für das Drupal 9 Upgrade benötigen könnten

Wenn ich mein jetziges Ich mit dem Ich von vor fünf Jahren vergleiche, würde ich viele Veränderungen in meiner Art, mich zu kleiden, in meiner Art zu sprechen und vor allem in meinem Berufsleben und der Position, die ich in meiner Karriere erreicht habe, feststellen. Ich bin stolz auf all diese Veränderungen. Ich verdiene ein Schulterklopfen. 

Das Gleiche gilt für Software: Wenn sich Menschen im Laufe der Zeit verändern, muss sich auch die Software, die sie entwickeln, verändern. Und genau darum soll es heute gehen. 

Drupal wird 20 und die 9. Version ist erschienen, wobei die 10. bereits in Sicht ist. Die Software hat in ihrer Existenz viele Veränderungen erfahren, es gab viele Versionen von Drupal und alle waren hervorragend. Wie ich verdient auch Drupal ein virtuelles Schulterklopfen.

Ein Update wird oft mit Fortschritt assoziiert, und welcher Schaden kann dabei entstehen? Es liegt also auf der Hand, dass die Leute auf die neueste Version von Drupal umsteigen wollen, indem sie auf Drupal 9 aktualisieren. 

Nach dem letzten Drupal-Upgrade, das eine Hauptversion war und eine Menge Arbeit und Mühe erforderte, zögern einige von uns, und das wahrscheinlich zu Recht. Das ist aber nicht nötig.

Laut Drupal.org: 

Drupal 9 bringt alle Funktionen von Drupal 8 mit und setzt seine kontinuierliche Innovation mit neuen Funktionen zweimal jährlich fort.

Das bedeutet, dass Drupal 9 Drupal 8 entspricht, abzüglich der veralteten APIs, was es zu einem kleineren Versions-Upgrade macht. Logischerweise würde das Upgrade also keine Überholung der Infrastruktur Ihrer Website erfordern, und das tut es auch nicht. Das folgende Bild beschreibt diese Vorstellung recht gut. 

In diesem Blogbeitrag werde ich nicht über den Upgrade-Prozess selbst sprechen, bei dem wir uns alles von Drupal Core bis hin zu benutzerdefiniertem Code ansehen, sondern über die Tools, die dafür benötigt werden. Beginnen wir also mit der Zusammenstellung der Upgrade-Tools und bereiten wir uns auf Drupal 9 vor.

Upgrade-Status 

Über die Drupal 9-Readiness kann man nicht sprechen, ohne den Upgrade-Status zu erwähnen. Es ist das wichtigste Werkzeug, um das Upgrade erfolgreich zu gestalten. 

Was macht es also?

Es führt so ziemlich jede wichtige Funktion aus, die erforderlich ist, um Sie für das Upgrade vorzubereiten. 

Was könnte das beinhalten?

Sorgt dafür, dass Sie auf eine aktuelle Version aktualisieren 

Für das Upgrade müssen Sie die neueste Version von Drupal 8 verwenden, entweder Drupal 8.8 oder Drupal 8.9. Der Upgrade-Status prüft nicht nur, welche Version Sie verwenden, sondern schlägt Ihnen auch ein Update vor, damit Sie es nicht vergessen.

Sorgt dafür, dass Sie die Systemvoraussetzungen überprüfen 

Das Upgrade hat auch spezifische Systemanforderungen, von Apache über PHP bis hin zu MySQL. Jede dieser Komponenten muss auf eine Version aktualisiert werden, die mit dem Upgrade kompatibel ist. Und was meinen Sie? Der Upgrade-Status prüft, ob Sie die Anforderungen erfüllen oder nicht. 

Sorgt dafür, dass Sie sich auf mitwirkende Projekte konzentrieren 

Von den Systemanforderungen kommen wir nun zu den mitwirkenden Modulen. Dieses Upgrade-Tool hat die Fähigkeit, sich in den Update-Status zu integrieren, um Sie an die mitwirkenden Projekte und deren Aktualisierung zu erinnern. Normalerweise ist ein D8-Projekt mit D9 kompatibel. Wenn Sie es also aktualisieren, funktioniert es weiterhin einwandfrei mit Ihrer Drupal 8-Site.

Sorgt dafür, dass Sie andere Kompatibilitätsprobleme beheben

Sie würden denken, dass diese drei Punkte ausreichen sollten, aber das ist noch nicht alles. Es gibt eine ganze Reihe von Drupal 9-Kompatibilitätsproblemen, die durch einen PHPStan-Lauf behoben werden müssen. Und der Upgrade-Status kann das auch. 

Der Upgrade-Status kann sich auch in Drush integrieren. Sie müssen ihn mit Composer installieren. Wenn ich den Upgrade-Status und seine Arbeit als Drupal 9-Upgrade-Tool beschreiben müsste, würde ich einfach sagen, dass es ein Tool ist, das prüft, ob Sie vorbereitet und bereit sind, den endgültigen Update-Button zu drücken.

Drupal Check

Das nächste wichtige Tool für die Migration zu Drupal 9 ist Drupal Check. PHPStan wurde als statisches Analyse-Tool entwickelt, das eine eigenständige PHP-Datei über die Befehlszeile ausführen kann.

Was wird damit erreicht?

Die Ergebnisse beziehen sich auf veralteten Code. Drupal Check meldet jeden veralteten Code, der auf Ihrer Website verwendet wird. Mit anderen Worten, es prüft die Korrektheit Ihres Projekts, indem es alle Fehler hervorhebt.

Für ein reibungsloses Upgrade muss Ihr System zu 100 % mit Drupal 9 kompatibel sein. Dazu gehören der benutzerdefinierte Code, die benutzerdefinierten Module, die mitwirkenden Module und der Migrationscode, wenn Sie von Drupal 7 auf Drupal 8 aktualisieren. 

Aber das klingt ähnlich wie der Upgrade-Status.

Ja, das tut es. Es gibt einige Ähnlichkeiten zwischen Drupal Check und dem Upgrade-Status in der Hinsicht, dass beide auf die Herstellung der Drupal 9-Kompatibilität hinarbeiten. Ich würde jedoch sagen, dass der Upgrade-Status dies in einem viel größeren Umfang tut.

Upgrade Rector und Drupal Rector

Würden Sie es vorziehen, einen automatisierten Mechanismus zu verwenden, um die unerwünschten veralteten APIs vor dem D9-Upgrade abzufangen, oder würden Sie es lieber manuell tun? Ich bin mir ziemlich sicher, dass Ihre Antwort meiner ähneln und die erste Wahl sein würde. 

Und diese automatisierten Veralteten-Prüfungen und Code-Fixes kommen mit Upgrade Rector. Dies ermöglicht Ihnen auch, Patches für sowohl benutzerdefinierte als auch mitwirkende Projekte durch Vorschläge zu erstellen. Im Wesentlichen ist Upgrade Rector die integrierte UI von Drupal für Drupal Rector. 

Was ist also Drupal Rector?

Bevor ich auf Drupal Rector eingehe, wollen wir uns die Geschichte von Rector ein wenig ansehen. Es ist ein Tool, das PHP-Code-Upgrades automatisiert und PHP verstanden hat, um Platz für komplexe Edge Cases zu schaffen. 

Nun, Drupal Rector hat dieses Konzept aufgegriffen und es auf Drupal implementiert. Sein Vorgänger war Drupal 8 Rector. Das Ziel war hier, Code-Updates von Drupal 8 auf 9 effizient zu automatisieren. 

Was macht es?

Als eine Reihe von Rector-Regeln aktualisiert Drupal Rector eine veraltete API, die in Drupal verwendet wird. Sie werden bemerkt haben, dass ich nicht die Pluralform wie in veraltete APIs verwendet habe, da dies noch nicht der Umfang dieses Tools ist. 

Seien Sie nicht enttäuscht. Warum?

Das liegt daran, dass die veraltete API, auf die es abzielt, etwa ein Viertel aller API-Veraltungen ausmacht. Die Verwendung dieses Tools spart Ihnen also eine Menge Zeit und Mühe und eliminiert jede Chance auf menschliche Aufsicht, da der Prozess automatisiert ist. 

Natürlich gibt es zukünftige Pläne für das automatisierte Tool. Die Hoffnung ist, es in Drupal.org zu integrieren und Rector-Regeln für bis zu 15 der häufigsten veralteten API-Verwendungen zu erstellen.

IDE

Es besteht die Möglichkeit, dass Sie eine integrierte Entwicklungsumgebung (IDE) oder einen Code-Editor verwenden, um Ihren Drupal-Code zu entwickeln. 

Was sollten Sie tun, wenn das der Fall ist?

Die Antwort ist, eine IDE oder einen Code-Editor zu verwenden, der Veraltungen einfach und effektiv verstehen und identifizieren kann. 

Warum ist das wichtig?

Dafür gibt es zwei Gründe: 

• Der eine hängt mit der Sichtbarkeit zusammen. Wenn Ihre IDE Veraltungen versteht, würde sie diese auch während des Entwicklungsprozesses sehr sichtbar machen. 
• Und zweitens würde sie Aufrufe an veraltete Methoden abbrechen und Sie weiter über den richtigen Aufruf informieren.

PHPStorm ist ein Beispiel für ein IDE-Tool, das sich bei der Erwägung eines Upgrades auf Drupal 9 als sehr nützlich erweist.

Drupal.org-Testunterstützung 

Für weitere Veralteten-Prüfungen bietet die drupal.org-Testunterstützung auch Möglichkeiten, die unerwünschten zu identifizieren.

Sie können dies tun, indem Sie die Testsuite Ihres Moduls ausführen und sie so konfigurieren, dass sie fehlschlägt, wenn ein veralteter Codepfad erreicht wird. Sie müssten Ihre Testabdeckung für die optimalen Ergebnisse erweitern. Es gibt auch die Möglichkeit, PHPStan zu verwenden, um ein Build-Artefakt zu generieren, das die Tests Ihres Projekts nicht behindert.

Auch hier gibt es einige Ähnlichkeiten zwischen diesem Tool und dem Upgrade-Status und Drupal Check aufgrund des PHPStan-Laufs.

Modul-Upgrader 

Der Modul-Upgrader ist ein Tool, das sich mehr auf Projekte konzentriert, die auf Drupal 7 laufen. Nach einem Befehlszeilenskript mit der Fähigkeit, die Quelle eines D7-Moduls zu scannen, kann es Code hervorheben, der nicht mit Drupal 8 oder 9 kompatibel ist. 

Wie funktioniert es?

• Es kennzeichnet den Code, der aktualisiert werden muss; 
• Es hebt die API-Änderungen hervor, falls erforderlich; 
• Es kann den D7-Code auch automatisiert in D8 oder 9 konvertieren.

Was ist das Ergebnis?

Sie erhalten aktualisierte Module, die keinen veralteten APIs in ihrem Code haben. Sobald das passiert ist, sind Sie dem eigentlichen Upgrade auf Drupal 9 einen Schritt näher gekommen. Denken Sie daran, dass ein Drupal 8-Modul ohne Veraltungen ein gutes Drupal 9-Modul ist, da der einzige Unterschied zwischen den beiden die veralteten APIs sind.

Migrationstools 

Der Name ist eindeutig genug, Migrationstools ist ein Modul, das zusätzliche Tools für die Ausführung und Verwaltung von Migrationen zu Drupal 8 bereitstellt. 

Es funktioniert mit Drush und bietet Befehle für eine einfache Verwaltung. 

• Sie können die Liste der Migrationen und ihren Status einsehen; 
• Sie können Import- und Rollback-Operationen durchführen; 
• Sie können eine laufende Operation einfach stoppen; 
• Sie können die für die Zuordnung verfügbaren Felder auflisten und Nachrichten anzeigen, die für Migrationen relevant sind. 

Dies mögen kleine Funktionalitäten sein, aber sie können viel Komfort hinzufügen, um das einfachste Upgrade des Jahrzehnts noch einfacher zu machen.

Migrate Plus 

Das Migrate Plus-Projekt enthält Erweiterungen der Kernfunktionalität des Migrations-Frameworks und Beispiele. Es kann einfach als Konfigurationsentitäten implementiert werden, die in Bezug auf Laden, Modifikationen und anschließendes Speichern adaptiv sind.

Für ein besseres Verständnis des Drupal 9-Upgrades können Sie unseren Blog Drupal 9-Upgrade: FAQs lesen, und alle Ihre Fragen werden beantwortet. Und um mehr über Drupal 9 zu erfahren, schauen Sie sich Folgendes an:

• Webentwicklungsplanung und -strategien mit Drupal 9
• Alle Ihre brennenden Fragen zu Drupal 9
• Wichtige Module, um eine Drupal 9-Website zu starten
• Strategien für das Konfigurationsmanagement in Drupal 9

Fazit

Da haben Sie es, alle notwendigen Tools, die benötigt werden, um Ihren Upgrade-Prozess zu starten, der vor dem 21. November 2021 stattfinden muss. Um diesen Blog zu beenden, hier ist eine aktuelle Diskussion, die auf der DrupalCon North America 2021 stattfand und die das Gleiche für Sie hervorheben würde.