Umstellung der PHP-Version: Kompatibilitätstest, mehrere Versionen und Rollback

Kompatibilitätsprüfung beim PHP-Upgrade, getrennter Betrieb von PHP-FPM-Versionen, schrittweise Umstellung und ein getesteter Rollback-Plan.
Technische Zusammenfassung
Technologie
PHP 8.x, PHP-FPM, PHP_CodeSniffer, PHPCompatibility, Nginx, Apache, WP-CLI
Thema
Kompatibilität und Planung beim Wechsel der PHP-Hauptversion
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Kenntnisse in Linux-Paketverwaltung und PHP-FPM
  • Grundlegende Nutzung von Composer
  • Zugang zu einer Staging-Umgebung
In diesem Beitrag7 Abschnitte

Die PHP-Version im Panel zu ändern, dauert zwei Sekunden. Danach dauert es manchmal Tage, bis auffällt, dass ein altes eigenes Plugin, eine Theme-Funktion oder ein nachts laufendes Cron-Skript einen Fatal Error liefert; denn nur ein Teil der Website hört stillschweigend auf zu funktionieren. Deshalb behandeln wir den Wechsel der Hauptversion nicht als Einstellungsänderung, sondern als Aufgabe aus Kompatibilitätsanalyse, schrittweiser Umstellung mit mehreren Versionen und einem schriftlichen Rollback-Plan. Die folgenden Schritte richten sich an Systemadministratoren und Entwickler, die WordPress und eigene PHP-Anwendungen betreuen.

Gründe, die PHP-Version aktuell zu halten

Jeder PHP-Hauptzweig hat eine Phase mit aktivem Support und danach eine Phase mit ausschließlich Sicherheitskorrekturen; ist diese abgelaufen, erscheinen für den Zweig keine offiziellen Sicherheitspatches mehr. Die aktuellen Daten werden auf der Seite der unterstützten Versionen bei php.net veröffentlicht; planen Sie anhand dieser Seite.

Ein häufig übersehenes Detail: Distributionen wie Debian, Ubuntu LTS und RHEL können Sicherheitspatches für die PHP-Pakete in ihren Repositories während der Supportdauer der Distribution zurückportieren. Eine Versionsnummer, deren Support bei php.net beendet ist, kann also Patches erhalten, solange die Distribution Sicherheitssupport leistet. Bei Versionen aus Drittanbieter-Repositories (z. B. den Repositories von Ondřej Surý für Debian/Ubuntu oder dem Remi-Repository für RHEL-basierte Systeme) sollten Sie dieses Zurückportieren nicht erwarten. Prüfen Sie zuerst, woher das Paket stammt. Entscheiden Sie dann.

Der Grund jenseits der Sicherheit ist die Abhängigkeitskette: WordPress-Core, Plugins und Composer-Abhängigkeiten geben mit der Zeit die Unterstützung älterer PHP-Versionen auf. Eine Website, die auf altem PHP bleibt, kann irgendwann auch die Plugin-Version mit der Sicherheitskorrektur nicht mehr installieren. Planen Sie diese Kette zusammen mit der WordPress-Update-Richtlinie.

Kompatibilitätsanalyse und statischer Scan

Ziel ist es, vor der Umstellung so genau wie möglich die Frage zu beantworten: „Welcher Code bricht in der neuen Version?“ Dafür werden zwei sich ergänzende Methoden genutzt: statischer Scan und Beobachtung zur Laufzeit. Die eine ersetzt die andere nicht.

Inventar

Inventarisieren Sie zuerst den zu scannenden Code: eigene Themes und Plugins, mu-plugins, Cron-Skripte auf dem Server, per Composer eingebundene Bibliotheken. In der Praxis am häufigsten vergessen werden einzelne PHP-Skriptdateien, die jemand vor Jahren in /root oder ein Home-Verzeichnis gelegt hat und die aus der Crontab aufgerufen werden. Bei öffentlich verfügbaren Plugins ist die erste Prüfung, ob die aktuelle Version die Ziel-PHP-Version laut Angabe unterstützt und aktiv gepflegt wird; ein Plugin, das lange nicht aktualisiert wurde, ist unabhängig vom Scanergebnis riskant. Wie das Plugin-Inventar geführt wird, beschreibt der Beitrag Auswahl von WordPress-Plugins und Inventarverwaltung.

Scan mit PHPCompatibility

PHPCompatibility ist ein für PHP_CodeSniffer geschriebener Regelsatz; er sucht im Code nach Konstrukten, die in der Zielversion entfernt wurden oder deren Verhalten sich geändert hat. Für WordPress-Projekte gibt es das Paket PHPCompatibilityWP, das die eigenen Kompatibilitätsschichten von WordPress berücksichtigt:

composer require --dev phpcompatibility/phpcompatibility-wp:"*"

vendor/bin/phpcs -p wp-content/themes/firmen-theme \
    wp-content/plugins/eigenes-plugin \
    --standard=PHPCompatibilityWP \
    --runtime-set testVersion 8.3- \
    --extensions=php \
    --report=summary

testVersion 8.3- prüft, ob der Code mit PHP 8.3 und neuer kompatibel ist. Wichtige Einschränkung: Welche PHP-Versionen PHPCompatibility abdeckt, hängt von der verwendeten PHPCompatibility-Version ab. Die lange als stabile Linie geführte 9.x-Serie prüft überwiegend Änderungen bis PHP 7.4; Prüfungen für PHP 8.x kommen mit der 10.x-Linie. Prüfen Sie auf der Projektseite, ob Ihre installierte Version die Änderungen der Ziel-PHP-Version abdeckt. Falls nicht, ist ein „sauberes“ Ergebnis irreführend.

Ein statischer Scan kann typabhängige Fehler nicht erfassen; ob eine Funktion zur Laufzeit null erhält, ist aus dem Code nicht immer ersichtlich. Der zweite Schritt besteht darin, die Anwendung in der Testumgebung mit der neuen Version auszuführen und Fehler zu protokollieren:

; Staging-php.ini (oder php_admin_value in der Pool-Konfiguration)
error_reporting = E_ALL
display_errors  = Off
log_errors      = On
error_log       = /var/log/php/staging-php83.log

Spielen Sie anschließend die kritischen Abläufe (Formularversand, Bestellung, Suche, Aktionen im Admin-Bereich, Import/Export) manuell oder mit automatisierten Tests durch und lesen Sie das Log. Deprecated-Warnungen machen heute nichts kaputt; sie sind aber die Liste der Stellen, die in der nächsten Hauptversion zu Fehlern werden.

Häufige Inkompatibilitäten

Die meisten Probleme beim Wechsel von PHP 7.x auf 8.x fallen in wenige Gruppen. Die Tabelle ist nicht vollständig; maßgeblich sind die Migrationsabschnitte des php.net-Handbuchs für jede Hauptversion.

Version Änderung Typisches Symptom
8.0 each(), create_function() entfernt Fatal Error in altem Theme/Plugin
8.0 Viele Warnungen wurden zu TypeError/ValueError-Ausnahmen (z. B. count() auf nicht zählbaren Wert) Code, der früher mit einer Warnung durchlief, bricht ab
8.0 Vergleich von Zahl und nicht numerischem String geändert (0 == "abc" ist jetzt false) Stiller Logikunterschied in Bedingungen
8.1 Übergabe von null an Parameter eingebauter Funktionen, die kein null akzeptieren, ist veraltet Massenhaft Deprecated-Warnungen in den Logs
8.2 Erzeugung dynamischer Eigenschaften (undefinierte Property) ist veraltet Deprecated-Warnung bei alten Klassen
8.4 Implizit nullable Parametertypen sind veraltet Warnung bei typisierten Parametern mit Standardwert null

Der Vergleich von Zahl und String ist der heimtückischste. Er erzeugt keinen Fehler; nur das Ergebnis der Bedingung ändert sich. Ein statischer Scan kann diese Zeilen nicht immer markieren. Prüfen Sie Code für Formularvalidierung, Berechtigungsprüfung und Preisberechnung, der lose Vergleiche (==) verwendet, manuell.

Eine Quelle der Inkompatibilität ist auch der Server selbst. Für die neue Version müssen die PHP-Erweiterungen (mbstring, intl, gd, imagick, redis usw.) separat installiert werden; eigene php.ini-Einstellungen müssen in das Konfigurationsverzeichnis der neuen Version übertragen werden. Kopieren Sie die alte Datei nicht unverändert; übertragen Sie nur die geänderten Werte, damit die Standardwerte der neuen Version erhalten bleiben. Ein fehlendes Modul ist eine der häufigsten Ursachen der Beschwerde „Die Website zeigt eine weiße Seite“ und lässt sich mit einem Befehl erkennen:

# Unterschied der installierten Module zwischen zwei Versionen
diff <(php8.1 -m | sort) <(php8.3 -m | sort)

Mehrere PHP-Versionen auf demselben Server

Bei PHP-FPM läuft jede Version als eigener Dienst und öffnet einen eigenen Socket. So können Sie Websites auf demselben Server einzeln auf die neue Version umstellen. Gängige Anordnung unter Debian/Ubuntu:

apt install php8.3-fpm php8.3-mysql php8.3-mbstring php8.3-xml \
            php8.3-curl php8.3-gd php8.3-intl php8.3-zip

systemctl status php8.1-fpm php8.3-fpm
ls /run/php/
# php8.1-fpm.sock  php8.3-fpm.sock

Die Version pro Website bestimmt, an welchen Socket der Webserver PHP-Anfragen weiterleitet. In Nginx im betreffenden server-Block fastcgi_pass unix:/run/php/php8.3-fpm.sock;, in Apache mit mod_proxy_fcgi folgende Definition:

<FilesMatch \.php$>
    SetHandler "proxy:unix:/run/php/php8.3-fpm.sock|fcgi://localhost"
</FilesMatch>

Für jede Website einen eigenen Pool mit eigenem Benutzer und Socket zu definieren, ist sowohl für die Isolierung als auch für die Versionsumstellung die sauberste Struktur. Panels wie Virtualmin verwalten diese Pools pro Website; diese Ordnung beschreiben wir im Beitrag Server mit vielen Websites mit Virtualmin verwalten.

Schrittweise Umstellung und Test

Ordnen Sie auf einem Server mit mehreren Unternehmenswebsites die Umstellung von der Website mit dem geringsten Risiko bis zur kritischsten. Der Ablauf ist für jede Website gleich:

  1. Scan: Eigener Code wird mit PHPCompatibility gescannt, Befunde werden behoben; öffentlich verfügbare Plugins werden auf die aktuelle Version gebracht.
  2. Probe in der Testumgebung: Die Website wird in einer zur Produktion gleichwertigen Testumgebung mit der neuen PHP-Version betrieben; kritische Abläufe werden getestet, das Fehlerlog wird ausgewertet.
  3. Backup: Unmittelbar vor der Umstellung wird ein Datei- und Datenbank-Backup erstellt.
  4. Umstellung: Socket oder Pool der Website werden auf die neue Version umgestellt, Webserver und PHP-FPM werden neu geladen. Reload, nicht Restart; laufende Anfragen sollen abgeschlossen werden.
  5. Prüfung: Prüfen Sie die aktive Version nicht mit einer temporären Datei mit phpinfo(), sondern über eine Ansicht, die die über das Web laufende Version zeigt (in WordPress: Werkzeuge > Website-Zustand > Bericht > Server). wp --info zeigt die Kommandozeilenversion und ist für diese Prüfung nicht geeignet; lassen Sie auch keine temporären Testdateien auf dem Server.
  6. Beobachtung: In den ersten Stunden und Tagen werden Fehlerlog, 5xx-Rate und Antwortzeit überwacht. Wöchentlich oder monatlich laufende Cron-Jobs werden bei ihrem ersten Lauf gesondert geprüft.

Prüfen Sie auch die OPcache-Einstellungen: Stimmen opcache.memory_consumption und opcache.max_accelerated_files im Konfigurationsverzeichnis der neuen Version (z. B. unter Debian/Ubuntu /etc/php/8.3/fpm/conf.d/) nicht mit der alten Version überein, wird ein Performanceeinbruch nach der Umstellung für eine Inkompatibilität gehalten und der Fehler an der falschen Stelle gesucht.

Rollback-Plan und Überwachung

Der größte Gewinn der Anordnung mit mehreren Versionen ist ein einfaches Rollback. Solange der FPM-Dienst der alten Version läuft, ist ein Rollback in Sekunden möglich, indem der Socket der Website auf die alte Version umgestellt und neu geladen wird. Entfernen Sie die Pakete der alten Version daher erst, wenn nach der letzten Website-Umstellung die Beobachtungsphase abgelaufen ist.

Ein Rollback setzt aber nur die PHP-Seite zurück. Wurde mit der Umstellung auch eine Plugin- oder Anwendungsversion aktualisiert und hat diese das Datenbankschema geändert, bringt die Rückkehr zur alten PHP-Version die alte Plugin-Version nicht zurück. Legen Sie die PHP-Umstellung nicht in dasselbe Wartungsfenster wie Plugin- und Core-Updates. Ein Fenster, eine Variable.

Legen Sie die Rollback-Kriterien vorab schriftlich fest: Welche Fehlerart (Fatal Error, Fehlschlag in einem kritischen Ablauf) löst sofort ein Rollback aus, welche (Deprecated-Warnungen) wird vor Ort behoben? Ist die Beobachtungsphase vorbei, stoppen Sie den Dienst der alten Version, entfernen Sie die Pakete und aktualisieren Sie das Serverinventar.

Auf Servern mit mehreren Websites planen und setzen wir PHP-Umstellungen im Rahmen der Linux-VPS- und Virtualmin-Verwaltung um; bei WordPress-Websites begleiten wir die Kompatibilität von Plugins und Themes zusammen mit dem Prozess für WordPress-Sicherheit, Updates und Wartung. Bei alten Anwendungen mit sehr langer Inkompatibilitätsliste kann es nachhaltiger sein, statt weiter zu flicken die Option einer Modernisierung zu prüfen.

Häufig gestellte Fragen

Ist die Umstellung sicher, wenn der PHPCompatibility-Scan sauber ist?

Nein. Ein sauberes Ergebnis zeigt nur, dass keine statisch erkennbaren Probleme vorliegen. Zur Laufzeit ankommende null-Werte, lose Vergleiche mit geändertem Ergebnis und dynamische Aufrufe können im Scan unsichtbar bleiben. Sie müssen die kritischen Abläufe in der Testumgebung mit E_ALL-Fehlerberichterstattung durchspielen.

Machen Deprecated-Warnungen die Website kaputt?

Nein; der Code läuft weiter. Diese Warnungen zeigen aber, dass das betreffende Konstrukt in einer künftigen Hauptversion entfernt werden kann, und sie können massenhaft Logeinträge erzeugen. In der Produktion sollte display_errors ausgeschaltet sein; protokollieren Sie die Warnungen und beheben Sie sie im nächsten Entwicklungszyklus.

Wie viele PHP-Versionen kann ich auf demselben Server betreiben?

Da jede Version ein eigener PHP-FPM-Dienst ist, können technisch mehrere parallel laufen. In der Praxis bedeuten Updates, Erweiterungsinstallation und Überwachung jeder Version eigenen Aufwand; halten Sie die Zahl der Versionen außerhalb der Umstellungsphase so gering wie möglich.

Warum zeigt WP-CLI nach dem Wechsel der PHP-Version einer WordPress-Website die alte Version?

WP-CLI läuft nicht über den Webserver, sondern mit dem Standard-php-Binary der Kommandozeile. Um pro Website die neue Version zu verwenden, führen Sie WP-CLI mit explizitem PHP-Pfad in der Form /usr/bin/php8.3 /usr/local/bin/wp aus oder ändern Sie die Standard-php-Version des Systems bewusst.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge