Mein Webprojekt läuft nicht mehr nach PHP-Update – was nun?

Du hast gerade ein PHP-Update durchgeführt und plötzlich zeigt deine Website nur noch eine weiße Seite, Fehlermeldungen oder gar nichts mehr an? Keine Panik – das Problem "PHP Update Webprojekt kaputt" ist häufiger als du denkst und meist lösbar. In diesem Artikel zeige ich dir Schritt für Schritt, was du jetzt tun kannst.

Warum passiert das überhaupt?

PHP wird kontinuierlich weiterentwickelt. Neue Versionen bringen Sicherheitsverbesserungen und Performance-Optimierungen – aber auch Breaking Changes. Das bedeutet: Funktionen, die in PHP 7.4 noch liefen, können in PHP 8.1 oder 8.2 plötzlich Fehler verursachen.

Besonders kritisch wird es, wenn:

• Dein Projekt jahrelang nicht aktualisiert wurde
• Du veraltete Plugins oder Bibliotheken nutzt
• Der Hoster das Update ohne Vorwarnung durchführte
• Keine Backups existieren

Erste Hilfe: Das musst du sofort tun

1. PHP-Version zurücksetzen

Die schnellste Lösung: Stelle die alte PHP-Version wieder her. Bei den meisten Hostern geht das über das Control Panel (Plesk, cPanel, etc.) mit wenigen Klicks. Das gibt dir Zeit, das Problem in Ruhe zu analysieren.

Wichtig: Das ist nur eine temporäre Lösung. Alte PHP-Versionen erhalten irgendwann keine Sicherheitsupdates mehr.

2. Error-Logs aktivieren und prüfen

Ohne Fehlermeldungen tappst du im Dunkeln. Aktiviere die PHP-Fehlerausgabe in deiner php.ini oder .htaccess:

ini_set('display_errors', 1);
error_reporting(E_ALL);

Prüfe auch die Server-Logs deines Hosters. Dort findest du konkrete Hinweise darauf, welche Dateien oder Funktionen das Problem verursachen.

3. Backup einspielen (falls vorhanden)

Hast du ein aktuelles Backup? Dann spiele es ein und teste das Update in einer separaten Testumgebung. So kannst du ohne Zeitdruck herausfinden, was beim PHP Update dein Webprojekt kaputt gemacht hat.

Die häufigsten Ursachen und ihre Lösungen

Deprecated Functions wurden entfernt

PHP entfernt regelmäßig veraltete Funktionen. Beispiele:

• mysql_* Funktionen (entfernt in PHP 7.0)
• create_function() (entfernt in PHP 8.0)
• each() (entfernt in PHP 8.0)

Lösung: Ersetze diese Funktionen durch moderne Alternativen. Bei mysql_* nutzt du stattdessen MySQLi oder PDO. Bei create_function() verwendest du anonyme Funktionen.

Veraltete CMS- oder Framework-Version

WordPress, Shopware, Laravel – alle benötigen bestimmte PHP-Versionen. Ein WordPress 4.9 läuft nicht mehr sauber auf PHP 8.2.

Lösung: Update zuerst dein CMS/Framework, dann PHP. Bei WordPress: erst auf die neueste WordPress-Version, dann PHP aktualisieren. Bei Laravel: prüfe die Kompatibilitätsmatrix und führe schrittweise Updates durch.

Plugins und Dependencies sind inkompatibel

Ein einzelnes veraltetes Plugin kann dein gesamtes Projekt lahmlegen, wenn es nach einem PHP Update dein Webprojekt kaputt macht.

Lösung: Deaktiviere alle Plugins/Module und aktiviere sie einzeln wieder, um den Übeltäter zu identifizieren. Bei Composer-Projekten: Prüfe mit composer update --dry-run, welche Pakete aktualisiert werden müssen.

Syntax-Änderungen

PHP 8 führte Named Arguments, Union Types und Constructor Property Promotion ein – und machte einige alte Syntax-Konstrukte illegal.

Lösung: Tools wie PHPStan oder Rector scannen deinen Code automatisch und zeigen Kompatibilitätsprobleme auf. Rector kann viele Probleme sogar automatisch beheben.

So verhinderst du das Problem künftig

1. Testumgebung einrichten

Führe Updates niemals direkt in der Produktivumgebung durch. Eine Staging-Umgebung mit identischer Konfiguration ist Pflicht – auch für kleinere Projekte.

2. Regelmäßige Wartung statt großer Sprünge

Von PHP 7.2 direkt auf 8.2 zu springen ist riskant. Besser: Jährlich ein Minor-Update durchführen. So bleiben die Anpassungen überschaubar.

3. Automatisierte Tests

Unit- und Integration-Tests zeigen sofort, ob nach einem Update noch alles funktioniert. Bei Laravel-Projekten nutze ich Beispielsweise PHPUnit, bei Shopware die eingebauten Test-Suites.

4. Monitoring einrichten

Tools wie Sentry oder Bugsnag melden dir automatisch Fehler in der Produktivumgebung – oft noch bevor Nutzer sie bemerken.

Wann du professionelle Hilfe brauchst

Manche Situationen sind zu komplex für Quick-Fixes:

• Legacy-Code: Dein Projekt ist 10+ Jahre alt und niemand kennt mehr die Struktur
• Custom-Entwicklungen: Individualprogrammierungen ohne Dokumentation
• Zeitkritisch: Die Website muss sofort wieder laufen
• Kein Backup: Das Projekt existiert nur auf dem Live-Server

In solchen Fällen kostet dich stundenlanges Herumprobieren mehr als professionelle Unterstützung. Ein erfahrener Entwickler erkennt die Ursache oft in unter einer Stunde und kann Preise von ab 800€ für kleinere Fixes bis 3.000–8.000€ für komplexere Migrationen einschätzen.

Prävention ist günstiger als Reparatur

Ein typisches Szenario: Ein mittelständisches Unternehmen betreibt seit 2015 einen Custom-Shop auf Basis von PHP 5.6 und einer eigenen Framework-Lösung. Der Hoster kündigt das Support-Ende an. Plötzlicher Zeitdruck, keine Dokumentation, kein funktionierendes Backup.

Die Kosten für eine Notfall-Migration: 12.000–20.000€. Die Kosten für jährliche Wartung mit schrittweisen Updates: 1.500–3.000€ pro Jahr.

Die Rechnung ist simpel: Regelmäßige Wartung zahlt sich aus – finanziell und nervlich.

Fazit: Systematisch vorgehen statt Panik

Wenn nach einem PHP Update dein Webprojekt kaputt geht, bewahre Ruhe und gehe systematisch vor:

1. Alte PHP-Version wiederherstellen
2. Error-Logs analysieren
3. Ursache identifizieren (CMS, Plugins, Custom-Code)
4. In Testumgebung fixen
5. Update erneut durchführen

Bei kleineren Projekten schaffst du das oft selbst. Bei geschäftskritischen Anwendungen oder komplexen Custom-Lösungen spare nicht an der falschen Stelle.

Du suchst einen Laravel, Shopware oder Next.js Entwickler, der dein Webprojekt nach einem fehlgeschlagenen PHP-Update wieder zum Laufen bringt? Kostenloses Erstgespräch auf lonexa.de – ich analysiere deine Situation und gebe dir eine realistische Einschätzung zu Aufwand und Kosten.

Weitere Einblicke in meine Arbeitsweise findest du in meinen Referenzen, wo ich ähnliche Projekte erfolgreich umgesetzt habe.