--- title: "PHP-Version für WordPress aktualisieren: Kompatibilität prüfen und sicher umstellen" date: 2026-09-30T20:57:42+02:00 modified: 2026-11-08T08:35:10+01:00 category: wordpress type: how_to author: Marcel Schönfelder canonical: https://s-edv.com/anleitungen/wordpress-php-version-aktualisieren-kompatibilitaet-pruefen keywords: - WordPress - PHP - Updates - Kompatibilität - WP-CLI reading_time: 10 personalize_url: "https://s-edv.com/anleitungen/wordpress-php-version-aktualisieren-kompatibilitaet-pruefen#plugin_name={plugin_name}" variables: - name: plugin_name label: "Plugin-Name" default: "PLUGINNAME" --- # PHP-Version für WordPress aktualisieren: Kompatibilität prüfen und sicher umstellen ## Anpassbare Werte Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`: | Platzhalter | Bedeutung | Beispielwert | | --- | --- | --- | | `{{plugin_name}}` | Plugin-Name | `PLUGINNAME` | Link mit eigenen Werten: https://s-edv.com/anleitungen/wordpress-php-version-aktualisieren-kompatibilitaet-pruefen#plugin_name=PLUGINNAME Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server. *Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben. Die PHP-Version Ihres Webspaces entscheidet mit darüber, ob Ihre WordPress-Website Sicherheitskorrekturen erhält. WordPress selbst läuft laut offizieller Kompatibilitätstabelle in Version 7.1 mit PHP 7.4 bis 8.5, empfiehlt aber PHP 8.3 oder neuer. Das eigentliche Risiko beim Umstellen liegt selten im WordPress-Kern, sondern in älteren Plugins und Themes. Diese Anleitung zeigt, wie Sie die aktuelle Version feststellen, Erweiterungen vorab auf Probleme prüfen, die Umstellung beim Hoster oder auf dem eigenen Server durchführen und bei Fehlern kontrolliert zurückgehen. **Kurzfassung:** Lesen Sie die PHP-Version unter „Werkzeuge > Website-Zustand > Bericht > Server“ ab. Erstellen Sie ein vollständiges Backup, aktualisieren Sie WordPress, Plugins und Themes und prüfen Sie den Code mit `php -l` und aktiviertem Debug-Log, am besten auf einer Staging-Kopie. Stellen Sie danach die PHP-Version in der Verwaltungsoberfläche Ihres Hosters um und kontrollieren Sie Frontend, Backend und `debug.log`. Bei einem kritischen Fehler stellen Sie die alte Version wieder ein und klären das betroffene Plugin, bevor Sie es erneut versuchen. ## Voraussetzungen - [ ] **WordPress:** aktuelle Version (die Beispielausgaben beziehen sich auf WordPress 7.1.2). Ältere Versionen unterstützen neuere PHP-Versionen teilweise nicht, siehe Schritt 2. - [ ] **Rolle:** Benutzerkonto mit der Rolle Administrator im WordPress-Backend. - [ ] **Hosting-Zugang:** Login in die Verwaltungsoberfläche Ihres Hosters (Kundenmenü, Plesk, cPanel o. Ä.), in der die PHP-Version pro Domain einstellbar ist. Bei eigenem Server: SSH-Zugang mit Root- oder sudo-Rechten. - [ ] **Dateizugriff:** FTP/SFTP oder Dateimanager, um `wp-config.php` zu bearbeiten und `wp-content/debug.log` zu lesen. Optional SSH mit WP-CLI für die Prüfbefehle. - [ ] **Backup:** aktuelle Sicherung von Dateien und Datenbank, die Sie nachweislich zurückspielen können. - [ ] **Zeitfenster:** etwa 30 Minuten außerhalb der Hauptgeschäftszeit, damit ein Rückschritt keine Kunden trifft. Eine Staging-Kopie ist nicht zwingend, verringert das Risiko aber deutlich. Wie Sie eine Testinstanz auf einem NAS aufsetzen, beschreibt die Anleitung [WordPress auf dem Synology NAS als eigene Website oder Staging-Umgebung](https://s-edv.com/anleitungen/wordpress-synology-docker-eigene-website). ## Schritt 1: Aktuelle PHP-Version feststellen Öffnen Sie im Backend „Werkzeuge > Website-Zustand“. Im Reiter „Status“ meldet WordPress, ob die PHP-Version empfohlen, veraltet oder unsicher ist. Die genaue Versionsnummer finden Sie im Reiter „Bericht“ im aufklappbaren Abschnitt „Server“ in der Zeile „PHP-Version“. Notieren Sie diese Nummer, Sie brauchen sie für einen möglichen Rückschritt. Wichtig: Maßgeblich ist die Version, mit der der Webserver Ihre Seiten ausliefert. Auf der Kommandozeile kann eine andere PHP-Version laufen als im Webserver, etwa wenn der Hoster mehrere Versionen parallel installiert hat. Der Wert im Website-Zustand stammt aus dem Webserver und ist deshalb verlässlich. Mit WP-CLI sehen Sie zusätzlich, was WordPress intern als Empfehlung und Minimum führt: ```bash $ wp eval 'print_r( wp_check_php_version() );' ``` Auf WordPress 7.1.2 liefert das unter anderem `[recommended_version] => 8.3` und `[minimum_version] => 7.4`. Beachten Sie, dass dieser Befehl mit der PHP-Version der Kommandozeile läuft. > **Prüfen:** Sie haben die PHP-Version aus „Website-Zustand > Bericht > Server“ notiert und wissen, ob WordPress sie als empfohlen einstuft. ## Schritt 2: Zielversion festlegen Wählen Sie die Zielversion nach zwei Kriterien: WordPress muss sie unterstützen, und das PHP-Projekt muss sie noch mit Sicherheitsupdates versorgen. Die Tabelle fasst die Angaben aus dem [Core-Handbuch](https://make.wordpress.org/core/handbook/references/php-compatibility-and-wordpress-versions/) und der Seite [Supported Versions auf php.net](https://www.php.net/supported-versions.php) zusammen. | PHP | Unterstützt von WordPress 7.1 | Aktiver Support bis | Sicherheitsupdates bis | | --- | --- | --- | --- | | 8.2 | ja | 31.12.2024 | 31.12.2026 | | 8.3 | ja | 31.12.2025 | 31.12.2027 | | 8.4 | ja | 31.12.2026 | 31.12.2028 | | 8.5 | ja | 31.12.2027 | 31.12.2029 | PHP 8.1 und älter erhalten vom PHP-Projekt keine Sicherheitsupdates mehr. PHP 8.2 fällt Ende 2026 heraus. Für die meisten Unternehmenswebsites ist PHP 8.3 oder 8.4 derzeit ein vernünftiges Ziel: beide sind von WordPress unterstützt und haben noch mindestens ein Jahr Sicherheitssupport. PHP 8.5 ist die neueste Version; hier ist die Wahrscheinlichkeit am größten, dass ein selten gepflegtes Plugin noch Warnungen erzeugt. Springen Sie von einer sehr alten Version wie 7.4 besser nicht direkt auf die neueste, sondern auf eine Zwischenstufe wie 8.3, und prüfen Sie dort gründlich. Umgekehrt gilt: Läuft Ihre Website noch mit einer alten WordPress-Version, aktualisieren Sie zuerst WordPress. WordPress 6.8 etwa ist laut Tabelle nicht für PHP 8.5 freigegeben. > **Prüfen:** Ihre Zielversion steht in der Spalte „Unterstützt von WordPress 7.1“ auf „ja“ und hat noch mindestens zwölf Monate Sicherheitsupdates. ## Schritt 3: Backup erstellen und alles aktualisieren Sichern Sie Dateien und Datenbank, bevor Sie irgendetwas ändern. Die Sicherung hilft nur, wenn Sie beim Zurückspielen auch die alte PHP-Version wieder einstellen, denn eine Seite, die auf dem neuen PHP abstürzt, stürzt nach dem Restore auf demselben PHP erneut ab. Mit WP-CLI sichern Sie die Datenbank so: ```bash $ wp db export vor-php-wechsel.sql ``` Legen Sie die Datei außerhalb des öffentlich erreichbaren Webverzeichnisses ab oder laden Sie sie direkt herunter. Aktualisieren Sie anschließend unter „Dashboard > Updates“ WordPress, alle Plugins und alle Themes. Neue Plugin-Versionen enthalten oft genau die Anpassungen an neuere PHP-Versionen. Prüfen Sie außerdem, welche Plugins seit Jahren keine Aktualisierung mehr erhalten haben: Ein Plugin ohne Pflege wird für neue PHP-Versionen selten nachgebessert. ```bash $ wp plugin list --fields=name,status,version,requires_php,update ``` Die Spalte `requires_php` zeigt die im Plugin-Kopf angegebene Mindestversion. Sie sagt nichts darüber aus, ob ein Plugin mit einer neueren Version funktioniert, nur ob es mit einer zu alten Version aktiviert werden darf. PHP-Umstellungen erfordern regelmäßig Backups, Updates und Kompatibilitätsprüfungen. Wer diese Pflege nicht selbst im Kalender halten möchte, kann sie abgeben: Die [WordPress-Wartung von wordpressupdate.de](https://wordpressupdate.de/?utm_source=s-edv.com&utm_medium=artikel&utm_campaign=6) übernimmt Updates von WordPress, Plugins und Themes mit Kompatibilitätsprüfung sowie wöchentliche Backups auf externen Speicher. > **Prüfen:** „Dashboard > Updates“ meldet keine ausstehenden Aktualisierungen, und die SQL-Sicherung liegt mit aktuellem Datum außerhalb des Webservers. ## Schritt 4: Plugins und Themes auf Kompatibilität prüfen Eine vollständige automatische Prüfung gibt es nicht. Das von WordPress.org früher empfohlene Plugin „PHP Compatibility Checker“ ist laut seiner Plugin-Seite nicht mehr gepflegt und erhält keine Sicherheitsupdates, deshalb sollten Sie es auf einer Produktivseite nicht mehr installieren. Kombinieren Sie stattdessen zwei Prüfungen, am besten auf einer Staging-Kopie, die bereits mit der Zielversion läuft. **Syntaxprüfung:** `php -l` prüft jede Datei mit dem PHP-Parser der aufgerufenen Version. Damit finden Sie Code, der auf der neuen Version gar nicht mehr geladen werden kann. Führen Sie den Befehl mit der Zielversion im WordPress-Verzeichnis aus: ```bash $ find wp-content/plugins wp-content/themes -name "*.php" -exec php -l {} \; 2>&1 | grep -v "^No syntax errors" ``` Unter PHP 8.4 liefert eine Datei mit der seit PHP 8.0 entfernten Schreibweise `$y{0}` diese Meldung: Ausgabe: ```plaintext PHP Parse error: syntax error, unexpected token "{" in wp-content/plugins/alt2.php on line 2 Errors parsing wp-content/plugins/alt2.php ``` **Laufzeitprüfung:** Der Syntaxtest erkennt keine entfernten Funktionen, die erst beim Ausführen auffallen. Dafür aktivieren Sie das Debug-Log in der `wp-config.php` und rufen die wichtigsten Seiten sowie Backend-Funktionen auf (Kontaktformular, Shop-Kasse, Seiteneditor): Datei: `wp-config.php` ```php define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); ``` Mit `WP_DEBUG_DISPLAY` auf `false` landen Meldungen nur in `wp-content/debug.log` und nicht im Browser Ihrer Besucher. Details zu den Konstanten erklärt die Anleitung [WordPress Debug-Modus aktivieren und Error-Logs analysieren](https://s-edv.com/anleitungen/wordpress-debug-modus-error-logs-fehler-beheben). Bewerten Sie die Einträge nach Schwere: `PHP Deprecated` ist ein Hinweis auf künftige Probleme, die Seite funktioniert aber. `PHP Fatal error` und `PHP Parse error` bedeuten, dass die Seite oder die Funktion abbricht. > **Prüfen:** Der `php -l`-Lauf gibt keine Zeilen aus, und `debug.log` enthält nach dem Durchklicken keine Einträge mit `Fatal error` oder `Parse error`. ## Schritt 5: PHP-Version umstellen Wo Sie umstellen, hängt vom Betrieb ab. WordPress selbst bietet dafür keine Einstellung, weil PHP auf dem Server läuft. **Webhosting:** Bei den meisten Hostern stellen Sie die PHP-Version pro Domain oder Webspace in der Verwaltungsoberfläche ein. Die genaue Bezeichnung unterscheidet sich je Anbieter; suchen Sie in der Hilfe Ihres Hosters nach „PHP-Version“. WordPress.org führt eine [Seite mit Hinweisen zum PHP-Update](https://wordpress.org/support/update-php/), die auch eine Vorlage für die Anfrage an den Hoster enthält. Achten Sie darauf, nur die Domain umzustellen, die Sie geprüft haben, wenn im selben Paket weitere Websites liegen. **Eigener Server mit PHP-FPM:** Hier installieren Sie die Zielversion samt den Erweiterungen, die WordPress laut [Hosting-Handbuch](https://make.wordpress.org/hosting/handbook/server-environment/) benötigt oder empfiehlt (unter anderem `mysqli`, `curl`, `mbstring`, `intl`, `imagick` oder `gd`, `zip`), und verweisen den virtuellen Host auf den neuen FPM-Pool. Übernehmen Sie eigene Werte aus der alten `php.ini`, etwa `memory_limit` und `upload_max_filesize`, denn jede PHP-Version hat eine eigene Konfiguration. Die Grundeinrichtung beschreibt [WordPress nativ auf Ubuntu mit Apache, MariaDB und PHP-FPM](https://s-edv.com/anleitungen/wordpress-nativ-ubuntu-lamp-apache-mariadb-php-fpm). **Docker:** Beim offiziellen Image steckt die PHP-Version im Tag, etwa `wordpress:7.1.2-php8.4-apache`. Sie ändern das Tag in der Compose-Datei und erstellen den Container neu. Die Daten liegen im Volume und bleiben erhalten: ```bash $ docker compose pull $ docker compose up -d ``` > **Prüfen:** „Werkzeuge > Website-Zustand > Bericht > Server > PHP-Version“ zeigt die neue Version. Bei PHP 8.4.26 stuft der Reiter „Status“ die Version als empfohlen ein und nennt die Versionsnummer. ## Schritt 6: Nach der Umstellung kontrollieren Rufen Sie direkt nach dem Wechsel die Startseite, zwei bis drei Unterseiten, ein Formular und das Backend auf. Bei einem Shop gehört ein Testkauf bis zur Bestellübersicht dazu. Prüfen Sie anschließend das Debug-Log: ```bash $ tail -n 50 wp-content/debug.log ``` Beobachten Sie das Log einige Tage lang, denn manche Funktionen laufen nur zeitgesteuert, etwa Newsletter-Versand oder Import-Aufgaben per WP-Cron. Schalten Sie danach `WP_DEBUG` wieder auf `false` und löschen Sie die `debug.log`, weil sie Pfade und Details Ihrer Installation enthält und bei manchen Serverkonfigurationen öffentlich abrufbar ist. > **Prüfen:** Alle geprüften Seiten laden ohne den Hinweis „Auf dieser Website ist ein kritischer Fehler aufgetreten“, und das Log enthält keine neuen Fatal-Einträge. ## Typische Fehler **„Auf dieser Website ist ein kritischer Fehler aufgetreten.“** Ein Plugin oder Theme ruft Code auf, den es in der neuen Version nicht mehr gibt. So erzeugt ein Plugin mit der in PHP 8.0 entfernten Funktion `create_function()` genau diese Meldung im Frontend und im Log den Eintrag `PHP Fatal error: Uncaught Error: Call to undefined function create_function()` mit Pfad zur Plugin-Datei. Lösung: Plugin über den Dateipfad identifizieren, per WP-CLI mit `wp plugin deactivate {{plugin_name}} --skip-plugins` abschalten, dann Update, Ersatz oder Rückkehr zur alten PHP-Version. **Plugin lässt sich nicht aktivieren.** Verlangt ein Plugin im Kopf eine höhere Version, verweigert WordPress die Aktivierung. Die Meldung lautet zum Beispiel: „Die aktuelle PHP-Version (8.4.26) entspricht nicht den Mindestanforderungen für PHP Test Neu. Das Plugin erfordert PHP 9.0.“ Das ist gewollt und schützt die Seite. **Deprecated-Meldungen im Browser.** Etwa `Implicitly marking parameter $a as nullable is deprecated` unter PHP 8.4. Die Seite funktioniert, aber `WP_DEBUG_DISPLAY` steht auf `true` oder fehlt. Setzen Sie es auf `false` und melden Sie die Warnung dem Plugin-Autor. **WP-CLI zeigt eine andere Version als der Website-Zustand.** Kommandozeile und Webserver nutzen verschiedene PHP-Binärdateien. Beim Hoster hilft oft ein versionierter Aufruf wie `php8.3`; fragen Sie im Zweifel beim Support nach dem Pfad. **Bildbearbeitung oder Uploads fehlen plötzlich.** Die neue PHP-Version wurde ohne Erweiterungen wie `imagick`, `gd` oder `zip` installiert. Der Reiter „Status“ im Website-Zustand weist auf fehlende Module hin. ## Häufige Fragen ### Wird meine Website durch ein PHP-Update schneller? WordPress.org nennt schnellere Ausführung als einen Vorteil neuerer Versionen. Wie groß der Effekt ist, hängt von Theme, Plugins und Caching ab. Der wichtigere Grund sind Sicherheitsupdates. ### Kann ich zur alten Version zurückwechseln? Ja, solange der Hoster sie noch anbietet. WordPress.org empfiehlt genau diesen Weg bei Problemen: alte PHP-Version wieder einstellen und bei Bedarf das Backup einspielen. Deshalb ist die notierte Versionsnummer aus Schritt 1 wichtig. ### Wie oft muss ich die PHP-Version wechseln? Jede PHP-Version erhält laut php.net insgesamt vier Jahre Support, zwei davon nur für Sicherheitslücken. Planen Sie etwa alle zwei Jahre einen Wechsel ein, dann bleiben Sie immer in einer gepflegten Version. ### Was ist, wenn der Hoster die alte Version zwangsweise abschaltet? Dann wird die Website ohne Ihre Prüfung umgestellt. Kündigt Ihr Hoster das an, ziehen Sie die Schritte 3 und 4 vor, damit Sie den Termin selbst bestimmen. ## Fazit Ein PHP-Wechsel ist kein großer Eingriff, wenn die Reihenfolge stimmt: Version feststellen, Ziel nach Support-Zeitraum wählen, sichern, aktualisieren, auf Staging prüfen, umstellen und das Log beobachten. Der WordPress-Kern ist dabei selten das Problem, ungepflegte Plugins schon. Wenn Sie Updates, Kompatibilitätsprüfungen und Backups dauerhaft auslagern möchten, übernimmt das der [WordPress-Wartungsservice von Marcel Schönfelder](https://wordpressupdate.de/?utm_source=s-edv.com&utm_medium=fazit&utm_campaign=6). ## Weiterführende Anleitungen und Quellen - [WordPress Debug-Modus aktivieren: Error-Logs analysieren und Fehler selbst beheben](https://s-edv.com/anleitungen/wordpress-debug-modus-error-logs-fehler-beheben) - [WordPress nativ auf Ubuntu installieren: Apache, MariaDB und PHP-FPM](https://s-edv.com/anleitungen/wordpress-nativ-ubuntu-lamp-apache-mariadb-php-fpm) - [WordPress auf dem Synology NAS als Staging-Umgebung](https://s-edv.com/anleitungen/wordpress-synology-docker-eigene-website) - [WordPress Core Handbook: PHP Compatibility and WordPress Versions](https://make.wordpress.org/core/handbook/references/php-compatibility-and-wordpress-versions/) - [WordPress Hosting Handbook: Server Environment](https://make.wordpress.org/hosting/handbook/server-environment/) - [WordPress.org: Requirements](https://wordpress.org/about/requirements/) - [php.net: Supported Versions](https://www.php.net/supported-versions.php)