🐘
PHP & MySQL

PHP-Unit-Testing mit PHPUnit: praktische Anleitung

📅 13 Oktober 2026 ✏️ 13 Oktober 2026 ⏱ 2 min leestijd

Erfahre, wie du PHPUnit für PHP-Unit-Testing einrichtest und nutzt – mit Schritten, Beispielen und Tipps für eine stabile Codebasis.

PHP-Unit-Testing mit PHPUnit bedeutet, dass du kleine, automatisierte Tests schreibst, die prüfen, ob einzelne Codeteile (Funktionen, Methoden) das richtige Ergebnis liefern. PHPUnit ist das meistgenutzte Testframework für PHP und lässt sich mit Composer integrieren. In diesem Artikel erfährst du, wie du PHPUnit installierst, deinen ersten Test schreibst, testgetrieben entwickelst und Tests ausführst, auch in einer Hosting-Umgebung.

Was ist PHPUnit und warum testen?

PHPUnit ist ein Testframework, mit dem du Unit-Tests schreibst: isolierte Tests, die eine einzelne Methode oder Funktion prüfen, ohne Abhängigkeiten wie eine Datenbank oder externe API. Ziel ist es, Regressionen frühzeitig zu erkennen, bevor sie in die Produktion gelangen. Ein guter Testbestand gibt Vertrauen beim Refactoring und macht deinen Code besser nachvollziehbar, da Tests auch als Dokumentation dienen.

Unit-Tests unterscheiden sich von funktionalen Tests oder End-to-End-Tests: Sie sind schnell, isoliert und konzentrieren sich auf Logik, nicht auf die gesamte Anwendung. Bei Webanwendungen kombinierst du sie häufig mit Integrationstests, aber die Grundlage beginnt bei PHPUnit.

QuellcodePHPUnitTestbericht OKTestbericht Fehler

PHPUnit installieren und konfigurieren

PHPUnit installierst du über Composer, den Standard-Paketmanager für PHP. Stelle sicher, dass dein Projekt eine composer.json hat, und führe Folgendes aus:

composer require --dev phpunit/phpunit

Anschließend erstellst du eine Konfigurationsdatei phpunit.xml im Hauptverzeichnis deines Projekts. Darin gibst du an, wo sich deine Testdateien befinden, zum Beispiel im Ordner tests/, und welche Bootstrap-Datei geladen wird (meist vendor/autoload.php).

In einer Shared-Hosting-Umgebung testest du meist lokal oder in einer Staging-Umgebung und bringst nur den getesteten Code live. Hast du einen VPS oder Server, auf dem du über SSH Composer und PHP CLI nutzen kannst, kannst du PHPUnit auch direkt auf dem Server ausführen. Prüfe im Zweifel bezüglich PHP-Versionen und CLI-Zugang die Einstellungen deines Webhosting-Pakets.

💡 Tipp: Halte Testabhängigkeiten immer im Bereich require-dev deiner composer.json, damit sie nicht mit in deine Produktionsumgebung gelangen.

Deine ersten Tests schreiben

Ein PHPUnit-Test ist eine Klasse, die von PHPUnitFrameworkTestCase erbt. Jede Methode, die mit test beginnt, wird automatisch ausgeführt. Ein einfaches Beispiel:

use PHPUnitFrameworkTestCase;

Was dit artikel nuttig?