WordPress PHP-Kompatibilität über Plugin-Versionen testen

WordPress-PHP-Kompatibilitätstesting bedeutet zu überprüfen, ob dein Plugin auf jeder Kombination aus PHP- und WordPress-Version, die du unterstützt, korrekt funktioniert. Mit einer WordPress-Sandbox auf wp.run kannst du saubere Testinstallationen starten — zum Beispiel PHP 8.4 mit WordPress 6.9 — und dann denselben Smoke-Test wiederholen, ohne lokale Server oder Produktionsrisiko.

Du kannst jetzt mit der ersten Prüfung beginnen: Klicke oben auf dieser Seite auf WordPress starten, wähle die PHP- und WordPress-Versionen aus, die du testen möchtest, und führe das Plugin in einer wegwerfbaren WordPress-Website mit echtem wp-admin-Zugang aus.

Warum WordPress PHP-Kompatibilität eine Matrix benötigt

Ein Plugin kann auf einem Stack bestehen und auf einem anderen scheitern. PHP-Änderungen können veraltete Syntax, strengeres Typverhalten, entfernte Funktionen oder Warnungen aufdecken, die auf einem älteren Runtime nicht aufgetreten sind. WordPress-Änderungen können Editor-Verhalten, Hooks, REST-Endpunkte, Admin-Screens und gebündelte JavaScript-Dateien beeinflussen.

Deshalb reicht eine einzelne „funktioniert auf meinem Rechner”-Prüfung nicht aus. Plugin-Kompatibilitätstesting sollte die Kombinationen abdecken, die deine Benutzer tatsächlich verwenden:

Das offizielle WordPress-Core-Handbuch pflegt eine PHP-Kompatibilitätstabelle für WordPress selbst. Behandle das als deine Basis für Core. Deine Aufgabe ist es, dein Plugin auf diesen Stacks zu testen, da WordPress-Core-Kompatibilität nicht garantiert, dass jedes Plugin oder Theme korrekt funktioniert.

Eine kleine PHP x WordPress-Versionsmatrix aufbauen

Beginne mit der kleinsten Matrix, die eine echte Freigabefrage beantwortet. Für die meisten Plugin-Teams bedeutet das drei Zeilen vor jeder bedeutenden Veröffentlichung:

1. Ältester unterstützter Stack. Dies deckt Syntax- oder API-Nutzung auf, die bei Benutzern bricht, die noch nicht aktualisiert haben.
2. Empfohlener aktueller Stack. Dies ist der Stack, den du für die meisten neuen Tests und Demos erwartest.
3. Neuester Stack. Dies deckt zukunftsorientierte PHP- und WordPress-Änderungen auf, bevor Benutzer sie melden.

Im wp.run-Startmodal werden explizite WordPress- und PHP-Versionsauswahlen unterstützt. Du kannst auch Start-URLs verwenden, wenn du eine WordPress-Sandbox starten von einem wiederholbaren Test-Link aus möchtest, zum Beispiel:

https://wp.run/new?php=8.4&wp=6.9

Für unterstützte Presets füge den Plugin-Parameter hinzu, um die Umgebung reproduzierbar zu machen:

https://wp.run/new?plugin=woocommerce&php=8.4&wp=6.9

Für deine eigenen Plugin-Builds lade das ZIP in wp-admin hoch und notiere den genauen Build in deinen Notizen. Jede Zeile in deiner Matrix sollte einen Stack, eine Plugin-Version, durchgeführte Prüfungen und ein Ergebnis haben.

Plugin-PHP-8.4-Kompatibilität auf wp.run testen

Verwende diesen Workflow, wenn du das PHP-8.4-Verhalten eines Plugins testen musst, ohne eine lokale Umgebung neu aufzubauen.

1. Den Ziel-Stack starten. Klicke auf WordPress starten, wähle PHP 8.4 und die WordPress-Version, die du validieren möchtest, dann erstelle die Sandbox. wp.run stellt eine temporäre WordPress-Installation mit Admin-Zugangsdaten und einer *.wprun.site-URL bereit.
2. Die Umgebung bestätigen. Öffne wp-admin, dann überprüfe unter Werkzeuge → Site Health → Info die PHP- und WordPress-Versionen, bevor du mit dem Testen beginnst.
3. Das Plugin installieren oder aktivieren. Lade ein unterstütztes Preset von einem Start-URL-Parameter, oder lade dein Plugin-ZIP in wp-admin hoch. Notiere den genauen Plugin-Build in deinem Testprotokoll.
4. Die Aktivierungsprüfung ausführen. Aktiviere das Plugin und achte auf schwerwiegende Fehler, Admin-Hinweise, fehlende Abhängigkeiten, Redirect-Schleifen und Setup-Assistent-Fehler.
5. Die Kernfunktion ausführen. Führe den kleinsten echten Workflow aus, den das Plugin unterstützen soll: ein Formular erstellen, einen Checkout abschließen, einen Block hinzufügen, eine Sitemap generieren, Inhalte importieren oder die geplante Aufgabe auslösen.
6. Admin- und Frontend-Oberflächen prüfen. Öffne den Block-Editor, Plugin-Einstellungen, öffentliche Seitenausgabe, REST-Endpunkte falls relevant und die Browser-Konsole.
7. Auf dem nächsten Stack wiederholen. Starte die nächste PHP- oder WordPress-Version und führe dieselbe Checkliste durch. Ändere eine Dimension nach der anderen, wenn du einen Fehler isolierst.

Das gibt dir schnell ein manuelles Kompatibilitätssignal. Es ersetzt keine Unit-Tests, Integrationstests oder statische Analyse, aber es deckt die produktseitigen Fehler auf, die Benutzer tatsächlich in wp-admin und im Frontend sehen.

Statisches Scanning hinzufügen, aber nicht dabei stehen bleiben

Statische Kompatibilitäts-Scanner sind nützlich, weil sie Code-Muster vor der Laufzeit erkennen. Die Learn WordPress-Lektion über das Testen von Produkten auf PHP-Versionskompatibilität behandelt zwei gängige Ansätze: manuelles Testen in einer Ziel-PHP-Umgebung und Scannen mit PHPCompatibility-Regeln über PHP_CodeSniffer.

Verwende beide Signale zusammen:

• Zuerst statischer Scan. Finde offensichtliche Verwendung entfernter Funktionen, veralteter Signaturen und versionsspezifischer PHP-Syntax.
• Dann Sandbox-Test. Bestätige, dass das Plugin startet, UI rendert, erwartete Optionen schreibt und seinen echten Workflow auf dem Ziel-Stack abschließt.
• Zuletzt Regressionsnotiz. Notiere, was scheiterte, die genauen PHP/WP/Plugin-Versionen und ob es sich um eine Warnung, einen schwerwiegenden Fehler, eine beschädigte UI oder ein Datenproblem handelt.

Statische Tools können dir sagen, dass eine Codezeile möglicherweise inkompatibel ist. Eine Sandbox sagt dir, ob das Plugin als WordPress-Produkt noch funktioniert.

Was beim WP-Versionstesting zu prüfen ist

WP-Versionstesting dreht sich nicht nur darum, ob das Plugin aktiviert wird. Die teuersten Bugs erscheinen oft nach der Aktivierung, wenn ein Benutzer Inhalte bearbeitet, Einstellungen konfiguriert oder von einer älteren Version aktualisiert.

Prüfe diese Bereiche in jeder Matrix-Zeile:

• Aktivierung und Deaktivierung. Das Plugin sollte sich sauber aktivieren, sauber deaktivieren und die Website nicht in einem fehlerhaften Zustand hinterlassen.
• Upgrade-Pfad. Installiere zuerst die vorherige Plugin-Version, erstelle Beispieldaten, aktualisiere dann auf die neue Plugin-Version und bestätige, dass Migrationen ausgeführt werden.
• Admin- und Editor-Screens. Öffne jedes Menü, das das Plugin hinzufügt. Wenn es Blöcke, Shortcodes, Einbettungen, Custom Post Types oder Meta-Boxen berührt, teste den Editor auf jeder WordPress-Version.
• Frontend-Ausgabe. Bestätige, dass Templates, Shortcodes, Assets, Weiterleitungen, Checkout-Abläufe, Formulare oder Widgets wie erwartet gerendert werden.
• REST-, AJAX- und geplante Aufgaben. Sende relevante Endpunktanfragen und prüfe Cron-abhängiges Verhalten, wo das Plugin auf Hintergrundarbeit angewiesen ist.
• Deinstallationshygiene. Deaktiviere und lösche das Plugin in einer wegwerfbaren Sandbox, um zu überprüfen, ob sein Bereinigungsverhalten akzeptabel ist.

Halte diese Checkliste konsistent. Wenn jeder Tester einen neuen Pfad durch wp-admin erfindet, wird deine Matrix schwerer zu vergleichen.

Eine praktische Matrix für eine Plugin-Veröffentlichung

Hier ist eine kompakte Matrix für ein Plugin-Team, das eine Veröffentlichung vorbereitet:

Nutze die Matrix als Freigabe-Gate, nicht als nachträgliche Dokumentation. Wenn eine Zeile scheitert, kopiere die genauen Schritte, füge Debug-Ausgabe oder Screenshots bei und hänge die temporäre Sandbox-URL an, während sie noch aktiv ist.

Häufige Kompatibilitätsfehler, auf die zu achten ist

Die meisten Kompatibilitätsfehler fallen in einige wenige Muster:

• Schwerwiegender Fehler bei der Aktivierung. Meist verursacht durch entfernte PHP-Funktionen, fehlende Klassen, Probleme beim Autoloading von Abhängigkeiten oder Code, der zu früh ausgeführt wird.
• Warnungen, die auf neuerem PHP lautstärker werden. Dynamische Eigenschaften, nullable Argumente, strikte Typisierungsannahmen und veraltete Signaturen können Logs fluten, auch wenn die Seite scheinbar funktioniert.
• Editor-Beschädigungen. Ein Plugin kann im Frontend funktionieren, während seine Block-Editor-Integration auf einer neueren WordPress-Version scheitert.
• AJAX-, REST- oder Upgrade-Fehler. Nonce-Handling, Routenregistrierung, gespeicherte Optionen oder benutzerdefinierte Tabellen können schwache Annahmen aufdecken.
• Abhängigkeitskonflikte. Zwei Plugins können inkompatible Versionen einer gemeinsamen PHP-Bibliothek oder eines JavaScript-Pakets mitliefern.

Wenn eine Zeile scheitert, spring nicht direkt zu „PHP ist inkompatibel.” Führe dasselbe Plugin auf derselben WordPress-Version mit der vorherigen PHP-Version erneut aus, dann ändere WordPress, während du PHP stabil hältst. Das Isolieren einer Dimension ist der Weg, um die echte Fehlerquelle zu finden.

Wo die Sandbox passt

Eine wegwerfbare WordPress-Sandbox ist ideal für Kompatibilitäts-Smoke-Tests, Release-Candidate-Prüfungen, Support-Reproduktion, Demo-Links und schnelle Plugin-QA. Verwende Staging oder lokale Entwicklung, wenn der Test von einer produktionsähnlichen Datenbank, persistenten Dateien, benutzerdefinierter Serverkonfiguration oder langem Debugging abhängt.

Der praktische Workflow ist geschichtet: Code scannen, automatisierte Tests ausführen, wp.run-Sandboxes für produktseitige PHP- und WordPress-Versionsprüfungen verwenden, dann zu Staging wechseln, nur wenn du eine spezifische Website verifizieren musst.

FAQ

Was ist WordPress PHP-Kompatibilität?

WordPress PHP-Kompatibilität ist die Fähigkeit von WordPress Core, einem Plugin oder einem Theme, auf einer bestimmten PHP-Version korrekt zu laufen. Für Plugins muss die Kompatibilität in einer echten WordPress-Umgebung getestet werden, da das Plugin von WordPress-Hooks, Admin-Screens, Datenbankverhalten und anderem aktiven Code abhängt.

Wie teste ich ein Plugin auf PHP 8.4?

Starte eine wp.run-Sandbox mit PHP 8.4, bestätige die PHP-Version in Site Health, installiere das Plugin, führe dann Aktivierungs-, Admin-, Editor-, Frontend-, REST/AJAX- und Deinstallationsprüfungen durch. Wiederhole dieselbe Checkliste auf der vorherigen PHP-Version, wenn du einen PHP-spezifischen Fehler isolieren musst.

Bedeutet WordPress-Core-Kompatibilität, dass mein Plugin ebenfalls kompatibel ist?

Nein. WordPress Core kann mit einer PHP-Version kompatibel sein, während ein Plugin noch wegen seines eigenen Codes, seiner Abhängigkeiten, Admin-UI oder Upgrade-Logik scheitert. Verwende das WordPress-Core-Kompatibilitätschart als Basis, dann teste das Plugin separat.

Wie viele PHP- und WordPress-Kombinationen sollte ich testen?

Teste den ältesten Stack, den du unterstützt, den aktuellen Standard-Stack, den du für die meisten Benutzer erwartest, und den neuesten Stack, auf den du dich vorbereiten möchtest. Füge Zeilen für Upgrade-Pfade, Abhängigkeiten oder kundenbetriebene Umgebungen hinzu, wenn diese relevant sind.

Kompatibilitätstesting wiederholbar machen

Der beste Kompatibilitätsprozess ist langweilig: eine Matrix, eine Checkliste, ein Ergebnisprotokoll, für jeden Release Candidate wiederholt. wp.run gibt dir die schnelle Umgebungsschicht für diesen Prozess: sauberes WordPress, wählbare PHP- und WordPress-Versionen, generierter Admin-Zugang und temporäre Sandboxes, die du verwerfen kannst, wenn jede Zeile abgeschlossen ist.