Mit WooCommerce PHP-Stubs kann Ihr Entwicklungsteam eigene Plugin-Anpassungen gezielter auf Aufrufe anderer Erweiterungen prüfen. Dafür müssen die verwendeten Erweiterungen und ihre unterstützten Versionen erfasst sein. So erhalten Sie vor einer Updatefreigabe einen nachvollziehbaren Codebefund, den Sie um einen Funktionstest des betroffenen Shopablaufs ergänzen.
Was bringen die PHP-Stubs Ihrem Shop?
PHP-Stubs sind Deklarationen von Klassen, Funktionen und Konstanten ohne deren ausführende Implementierung. Sie beschreiben einem Analysewerkzeug, welche Aufrufe eine Erweiterung bereitstellt. PHPStan nutzt solche Informationen zur statischen Codeanalyse: Es untersucht Code, ohne dabei eine Bestellung oder Zahlung auszuführen.
Stand: 04.11.2026: WooCommerce hat das Paket woocommerce/php-stubs am 03.11.2026 öffentlich vorgestellt. Die Ankündigung zu den WooCommerce PHP-Stubs richtet sich an Entwickler eigener Plugins und Themes, die andere Woo-Erweiterungen ansprechen. Laut Hersteller können sie diese Integrationen prüfen, ohne jede Erweiterung in der Analyseumgebung zu installieren.
Der Nutzen liegt in der Prüfung Ihrer eigenen Verbindungen zwischen Erweiterungen. Ein neues Werkzeug allein begründet noch keinen Eingriff in den Live-Shop.
Wie prüfen Sie eigene Plugin-Anpassungen?
Ein brauchbarer Prüfauftrag verbindet Abhängigkeiten, Versionszusagen und konkrete Shopabläufe. Die folgenden drei Schritte können Sie gemeinsam mit Ihrem Entwicklungsteam durchgehen.
Schritt 1: Anpassungen und Abhängigkeiten erfassen
Der erste Prüfschritt ist einfach: Fragen Sie Ihr Entwicklungsteam, ob eigener Plugin- oder Themecode überhaupt andere Woo-Erweiterungen aufruft. Das Team prüft dafür die Projektdateien; die Pluginliste im Shop allein beschreibt diese Codeverbindungen nicht vollständig.
Erfassen Sie je Anpassung die angesprochene Erweiterung, die eingesetzte Version, die unterstützte Mindestversion und eine verantwortliche Person. Die Mindestversion ist der älteste Versionsstand, mit dem Ihre Anpassung funktionieren soll. Diese Liste legt den Umfang der Analyse fest.
Wer Entwicklung und Betreuung zusammenführen möchte, findet dafür einen Anknüpfungspunkt in unserer WooCommerce-Entwicklung und Betreuung.
Schritt 2: Abdeckung und Versionsstand festlegen
Ihr Team prüft als Nächstes, ob die benötigte Erweiterung und ihr Versionsstand im Paket enthalten sind. Die Einbindung im offiziellen Paket-README beschreibt woocommerce/php-stubs als Entwicklungsabhängigkeit neben php-stubs/woocommerce-stubs. Die Einbindung in PHPStan erfolgt über includes, also eingebundene Konfigurationsdateien. Das gehört ins Entwicklungsprojekt, nicht als Funktionsplugin in den Shop.
WooCommerce empfiehlt, auf die erste Ausgabe der unterstützten Minor-Version, also x.y.0, festzulegen. Dieses sogenannte Pinning macht die Versionsgrundlage nachvollziehbar. latest.neon ist für Integrationen ohne erklärte Mindestversion vorgesehen. Eine Prüfung nur gegen den neuesten Stand belegt keine Unterstützung älterer Versionen.
Fehlende Paketabdeckung bleibt als offene Aufgabe dokumentiert. Ignorierte Meldungen schaffen für diesen Code keine zusätzliche Prüfung.
Schritt 3: Analyse und Funktionstest getrennt abnehmen
Lassen Sie den eigenen Integrationscode analysieren und die gefundenen Aufrufe prüfen. Das Team korrigiert Fehler oder dokumentiert begründete Ausnahmen. Zum Ergebnis gehören die verwendeten Versionen, die Analysekonfiguration und offene Befunde.
Anschließend wird der betroffene Geschäftsprozess in einer abgeschotteten Testumgebung ausgeführt. Beispiel: Verändert eine eigene Anpassung den Bestellabschluss, prüfen Sie diesen Ablauf mit den vorgesehenen Erweiterungen. Kontrolliert ausgewertete Fehlerprotokolle ergänzen den Test; sie gehören nicht öffentlich ins Netz.
Statische Analyse und Prozesslauf liefern unterschiedliche Nachweise. Legen Sie deshalb vorab fest, wer beide Ergebnisse abnimmt. Dabei können Sie Anforderungen und Verantwortlichkeiten klären, bevor aus einem Analyseergebnis eine Updatefreigabe wird.
Welcher Befund braucht welche Entscheidung?
Die folgende Abnahmematrix ist eine redaktionelle Entscheidungshilfe. Sie übersetzt typische Befunde in Zuständigkeiten und überprüfbare Ergebnisse.
| Befund | Entscheidung | Verantwortlich | Abnahmenachweis |
|---|---|---|---|
| Eigene Abhängigkeit unklar | Aufruf und Erweiterung identifizieren | Entwicklung und Shopverantwortliche | Abhängigkeitsliste mit Versionsstand |
| Erweiterung oder Zielversion fehlt im Paket | Andere Symbolquelle klären; Lücke sichtbar halten | Entwicklung | Dokumentierte Abdeckung oder offene Lücke |
| Unbekannte Klasse in der Analyse | Einbindung und Symbolerkennung zuerst prüfen | Entwicklung | Erneuter Lauf mit dokumentierter Konfiguration |
| Ungültiger Aufruf gegen Mindestversion | Code oder zugesagte Mindestversion korrigieren | Entwicklung und Produktverantwortliche | Korrektur und erneutes Analyseprotokoll |
| Statische Analyse bestanden | Betroffenen Shopablauf testen und abnehmen | Shopverantwortliche mit Entwicklung | Dokumentierter Funktionstest |
Ein Freigabeprotokoll zeigt damit, was geprüft wurde und was noch aussteht. Ein bestandener Analyselauf allein bestätigt weder einen funktionierenden Checkout noch das Zusammenspiel externer Systeme.
Wann passt ein anderer Prüfweg besser?
Vorhandener Fremdcode kann eine passende Symbolquelle sein, wenn die benötigte Erweiterung im Paket fehlt. Die Symbolerkennung von PHPStan beschreibt dafür scanFiles und scanDirectories. Darüber lassen sich Dateien oder Verzeichnisse für die Erkennung von Klassen, Funktionen und Konstanten bereitstellen, ohne diesen Fremdcode selbst zu analysieren.
Für das tatsächliche Verhalten bleibt ein gezielter Integrations- oder Funktionstest der passende Weg. Die WordPress-Dokumentation zum Debugging erläutert Fehlerprotokolle und automatisierte Tests in lokalen Entwicklungs- oder Stagingumgebungen. Staging ist eine vom produktiven Shop getrennte Testumgebung.
Die Auswahl folgt Ihrer Aufgabe: Symbolquellen ermöglichen die Codeprüfung; Prozessläufe prüfen das Verhalten. Beide Wege ergänzen sich.
Häufige Fragen
Braucht jeder WooCommerce-Shop PHP-Stubs?
Eigener Integrationscode ist der Anlass für diese Prüfung. Lassen Sie zuerst klären, ob Ihr Plugin oder Theme andere Erweiterungen anspricht. Das Paket ist ein Entwicklungswerkzeug und kein allgemeiner Schalter im WooCommerce-Adminbereich.
Sind alle Erweiterungen abgedeckt?
Die öffentliche Abdeckung umfasst Woo-eigene Erweiterungen und beigetretene Drittanbieter aus dem Marketplace. Ihr Team prüft deshalb jede tatsächliche Abhängigkeit samt Zielversion im Paketbestand. Für fehlende Abdeckung lässt sich eine andere geeignete Symbolquelle prüfen.
Was bedeutet class.notFound?
class.notFound bedeutet, dass PHPStan eine verwendete Klasse nicht kennt. Prüfen Sie zunächst Symbolerkennung und Einbindung. Die Meldung kann eine Lücke in der Analysekonfiguration anzeigen; sie beweist für sich allein keinen Fehler im laufenden Shop.
Ersetzen PHP-Stubs den Testshop?
Ein Testshop liefert den ergänzenden Nachweis für das tatsächliche Verhalten. PHP-Stubs helfen bei der statischen Prüfung von Aufrufen. Warenkorb, Zahlung oder externe Anbindungen benötigen je nach Anpassung einen eigenen Prozesslauf unter passenden Testbedingungen.
Wie aufwendig ist die Einführung?
Der Aufwand hängt von der vorhandenen Analysekonfiguration, den tatsächlichen Abhängigkeiten und dem Pflegezustand des Codes ab. Ihr Team benötigt Projektzugriff und klare Versionszusagen. Klären Sie zunächst diese Voraussetzungen sowie verfügbare Symbolquellen und die benötigten Funktionstests.
Quellen
- WooCommerce: Automated PHP stubs for Woo extensions, developer.woocommerce.com
- WooCommerce: WooCommerce Extension Stubs, github.com
- PHPStan: Discovering Symbols, phpstan.org
- WordPress: Debugging in WordPress, developer.wordpress.org
Alle Quellen abgerufen am 4. November 2026.
Marvin de Vries ist Geschäftsführer von ADence und der E-Commerce Agentur Hamburg. Seit 2011 entwickelt und betreut er mit seinem Team Onlineshops auf WooCommerce, Shopware und Magento, vom Aufbau bis zum sicheren Betrieb. Marvin de Vries auf LinkedIn
WooCommerce-Anpassungen betreuen lassen?
Im kostenlosen Erstgespräch klären wir Ihre Anforderungen an die Prüfung eigener Anpassungen und die passende weitere Betreuung.