Empfehlungen für das Vorgehen bei der PHP8.3-Umstellung

Wir empfehlen, bei der Umstellung auf PHP8.3 anhand der folgenden Schritte vorzugehen:

1

Vorbereitung

Zunächst sollten Sie oder Ihr Dienstleister alle zu überprüfenden Templates und Custom Functions exportieren und als Datei speichern.

Diese Templates bilden die Grundlage für die Analyse der betroffenen Codestellen Ihrer Eigenentwicklung.

Welche Codeänderungen es seit PHP7.4 gab bzw. gibt und ob ggfs. eine Relevanz für Eigenentwicklungen gegeben sein könnte, haben wir in der Excel-Datei "Analyse der Änderungen PHP-Update von 7.4 auf 8.3" (xlsx, 123.8 KB) zusammengefasst.

Ergänzend können Sie auch die folgenden Migrationsunterlagen auf der PHP-Webseite hinzuziehen:

Sollten Sie einen Dienstleister mit der Analyse beauftragen, weisen Sie ihn bitte unbedingt darauf hin, dass das Eigentum der Templates und Custom Functions ausschließlich bei Ihnen liegt und eine Weiterverwendung nicht gestattet ist.

2

Analyse der betroffenen Bereiche für die PHP8.3-Umstellung

Sie oder der Dienstleister überprüfen anhand der exportierten Dateien den Umsetzungsumfang und protokollieren die Analyseergebnisse.

Aus dieser Analyse erhalten Sie einen Überblick anhand einer Liste der betroffenen Stellen in Ihrer Eigenentwicklung.

Hieraus leiten Sie bzw. Ihr Dienstleister die jeweils notwendigen Codeanpassungen ab.

3

Anpassungen im System vor der PHP8.3-Umstellung

In Ihrer Ergebnisliste der zu ändernden Templates werden Sie Stellen finden, die abgekündigt sind. Hierfür gibt es in der Regel Lösungsalternativen, die dann für PHP7.4 und PHP8.3 gleichermaßen gelten, d.h. sie sind abwärtskompatibel.

Ob eine Abwärtskompatibilität vorliegt, können Sie in der Spalte "H" der o.g. Excel-Datei (xlsx, 123.8 KB) entnehmen.

Sind die Codeänderungen abwärtskompatibel, können und sollten die Anpassungen rechtzeitig vor der PHP-Umstellung auf 8.3 vorgenommen werden, sodass am Umstellungstag selbst keine Nachteile entstehen.

Wir empfehlen, diese Stellen bereits im alten (aktuellen) Stand (PHP7.4) anzupassen und online zu stellen - vor dem eigentlichen Umstellungstermin.

Für den KOGIS-Baukasten verfahren wir auf exakt diese Art und Weise.

4

Was bleibt nach der Umstellung zu tun?

Es kann vorkommen, dass es vereinzelt ein paar wenige Stellen in Ihren Eigenentwicklungen gibt, die erst am Umstellungstag (nach dem Update) angepasst werden können.

Diese Stellen sind nicht abwärtskompatibel und betreffen abgekündigte Funktionen, für die es eine Alternative in PHP8.3 gibt, die aber nicht unter PHP7.4 laufen.

Hierfür gibt es zwei Lösungsansätze:

Erstellen Sie von den betroffenen Templates Kopien im Livesystem, bereiten Sie diese Kopien mit den notwendigen Anpassungen vor und tauschen Sie am Umstellungstag einfach die Templates (alt gegen neu) aus.
Alternativ ließe sich das auch durch eine Bedingung im Code mit Prüfung auf die PHP-Version lösen, sodass beide PHP-Versionen (7.4 und 8.3) parallel betrieben werden könnten.
Nach Umstellung auf PHP8.3 wäre diese Bedingung dann wieder zu entfernen.

5

Ausnahmeregelungen

Bei den letzten großen PHP-Versionsumstellungen waren temporäre Entwicklungsinstanzen in der Regel nicht notwendig und werden auch nur in stichhaltig begründeten Ausnahmefällen eingerichtet.

Bitte sprechen Sie diesbezüglich mit Ihren jeweiligen Ressortansprechpersonen.

Sollten Ihre Analyseergebnisse eine sehr umfangreiche Anpassung von Codestellen erforderlich machen, melden Sie dies bitte der Kompetenzstelle CMS und Internet unter Angabe von:

Anzahl der anzupassenden Templates
Übersicht der anzupassenden Templates (jedes betroffene Template ist namentlich anzugeben)
Beschreibung der betroffenen Module

Kommt das KOGIS-Team nach Prüfung der Anforderung zu einer positiven Bewertung, stellt es eine temporäre Entwicklungsinstanz zur Verfügung.