Websites mit PHP 7 auf PHP 8.2 umstellen

Diese Anleitung betrifft Verantwortliche, die eine Website im ZDV gehostet haben.

Aktuell laufen einige Websites mit einer veralteten PHP-Version 7. Diese enthält potentielle Sicherheitslücken, da es für diese Version keinen Security-Support mehr gibt.

Bitte prüfen Sie bis Ende März 2023 ob Ihre Website mit PHP 8.2 kompatibel ist. Websites, für die wir bis zum 1. April keine Rückmeldung erhalten, müssen wir aus Sicherheitsgründen abschalten.

Dieses Vorgehen beruht auf einen Beschluss des Senatsausschusses für Informationstechnologie und Digitale Prozesse vom 20. März 2019. Dieser besagt, dass Dienste mit potentiellen Sicherheitslücken abgeschaltet werden können.

Bevor wir Ihre Website auf PHP 8.2 umstellen, prüfen Sie folgende Punkte

Benötigen Sie Ihre Website noch?

1. Wenn ja: Stellen Sie sicher, dass bis Ende März 2023 Ihre Website mit PHP 8.2 kompatibel ist.
2. Wenn nein: Geben Sie uns bitte direkt Bescheid: unix@zdv.uni-mainz.de. Wir schalten die Website ab.

Kontrollieren Sie die PHP-Dateien Ihrer Website.

• Wir haben für Sie vorab sämtliche PHP-Dateien Ihrer Website auf ihre Kompatibilität zu PHP 8.2 mit Hilfe eines Syntax-Checkers untersucht.
• Das Ergebnis mit möglichen Fehlermeldungen können Sie bei uns erfragen: unix@zdv.uni-mainz.de.
• Falls Fehler aufgeführt werden, korrigieren Sie diese bitte.
• Um einzelne Fehler zu beheben, benötigen Sie Kenntnisse in der PHP-Programmierung. Wenn es sich bei den PHP-Dateien nicht um eigens programmierte Skripte handelt, sondern um Teile eines installierten Software-Paketes (bspw. „Dokuwiki“ oder „Mediawiki“), überprüfen Sie, ob eine neuere Paket-Version PHP 8.2 bereits unterstützt.
• Spielen Sie die neuere Version ein und prüfen Sie, ob die Kompatibilitätsprobleme behoben sind.

Wie komme ich auf die Website? Link zur Anleitung

Testen Sie Ihre Website auf einer Test-Instanz.

Auf dieser Test-Instanz läuft Ihr Projekt mit der neuen PHP-Version 8.2. Ihre Test-Instanz können Sie auf zwei Wegen erreichen.

Zugriff auf Test-Instanz über den Vorschau-Server (empfohlen)

Windows

Im Campus-Netz können Sie sich unter Windows 8 oder neuer mit dem Vorschau-Server verbinden:

1. Öffnen Sie das Startmenü und klicken Sie auf das Windows-Symbol unten links.
2. Geben Sie in das Suchfeld Remotedesktopverbindung ein und bestätigen Sie die Suche mit der Eingabetaste.
3. Im Anschluss geben Sie den Computernamen webpreviewrds-1.jgu.net ein und verbinden sich mit dem Vorschau-Server.
4. Sollten Sie nach dem Benutzernamen gefragt werden, geben Sie bitte UNI-MAINZ\ANMELDENAME ein.

Linux

1. Verwenden das Programm xfreerdp.
2. Verbinden Sie sich von Ihrem Linux-Rechner aus über ein Terminal mit dem Vorschau-Server. Geben Sie dafür diesen Befehl ein: xfreerdp /u:ANMELDENAME /d:uni-mainz /sec:nla /size:1920x1100 /clipboard /v:webpreviewrds-1.JGU.NET
3. Ihre Test-Instanz erreichen Sie nun unter der URL Ihrer Website über einen Browser Ihrer Wahl auf dem Vorschau-Server.

Zugriff auf Test-Instanz über eigenen Arbeitsplatzrechner

💡Überspringen Sie diesen Abschnitt, wenn Sie auf die Test-Instanz über den Vorschau-Server zugreifen möchten.

Damit Ihr Browser die Test-Instanz anstatt der öffentlich zugänglichen Version aufruft, fügen Sie folgende Zeile der lokalen Hosts-Datei Ihres Arbeitsplatzrechners hinzu: 134.93.178.42 Domain Ihrer Website:

1. Diese Datei heißt unter Linux: /etc/hosts
2. Unter Windows: C:\Windows\System32\drivers\etc\hosts

Beispiel für eine Zeile in der Hosts-Datei: 134.93.178.42 unixwiki.zdv.uni-mainz.de

💡 Um die öffentliche Version ihrer Website wiederzusehen, entfernen Sie den Eintrag. Ansonsten wird Ihnen die Test-Instanz angezeigt.

Website auf PHP 8.2 umstellen

Wenn Sie sicher sind, dass Ihr Website kompatibel mit 8.2 ist, melden Sie sich bitte bei uns:
unix@zdv.uni-mainz.de. Wir stellen Ihre Website auf die neue Version um.

Fehler beheben

Wird Ihre Website nicht wie erwartet dargestellt, ist der Programm-Code Ihrer Website wahrscheinlich nicht mit der eingestellten PHP-Version kompatibel.

1. Prüfen Sie zunächst die Server-Log-Dateien über den Datei-Explorer.
2. Geben Sie folgenden Pfad in die Adressleiste Ihres Datei-Explorers ein:
   1. unter Linux: smb://fsinet.zdv.uni-mainz.de/wwwconfig$/VirtualHosts/Projektverzeichnis/logs
      Ersetzen Sie Projektverzeichnis durch die Domain Ihrer Website.
      Beispiel für ein Projektverzeichnis: unixwiki.zdv.uni-mainz.de
   2. unter Windows bzw. auf dem Vorschau-Server: \\fsinet.zdv.uni-mainz.de\wwwconfig$\VirtualHosts\Projektverzeichnis\logs
      Ersetzen Sie Projektverzeichnis durch die Domain Ihrer Website.
      Beispiel für ein Projektverzeichnis: unixwiki.zdv.uni-mainz.de
      
3. Authentifizieren Sie sich als registrierter Benutzer (nicht Anonymous). Die Domain lautet UNI-MAINZ. Als Benutzernamen verwenden Sie bitte Ihren herkömmlichen Benutzernamen ohne @uni-mainz.de.
4. Dateien, die mit php. beginnen, gehören zur öffentlich zugänglichen Version Ihrer Website (alte PHP-Version).
   Dateien, welche mit php-test. beginnen, beziehen sich hingegen auf die Test-Instanz (neue PHP-Version).
   Dateien, die mit .gz enden, müssen Sie nicht berücksichtigen.
5. Die Log-Dateien können Fehlermeldungen und konkrete Handlungsempfehlungen für PHP-Programmierer beinhalten. Bitte beheben Sie die aufgeführten Fehler, um die Kompatibilität mit PHP 8.2 sicherzustellen.
6. Testen Sie Ihre Website, indem Sie einzelne Seiten besuchen, und beheben Sie schrittweise weitere Fehler, welche fortlaufend in die Log-Dateien geschrieben werden.
7. Sobald alle Fehler behoben sind und sich die Website erwartungsgemäß verhält, geben Sie uns bitte Bescheid. Dann werden wir für Ihre Website PHP 8.2 aktivieren.