mitmario.dev

Warum Tests

PHP Sandbox 3 Min Lesezeit 3 BeispieleLektion 1 von 6

Eine Rabattfunktion, fünf Aufrufe, fünf Zahlen, und ob sie stimmen, prüfst du im Kopf. Änderst du morgen eine Grenze, rechnest du alle fünf noch einmal nach, oder du lässt es.

Wie es ohne Tests aussieht

Von Hand ausprobieren
<?php

declare(strict_types=1);

function rabatt(float $summe, bool $stammkunde): float
{
    $satz = 0.0;

    if ($summe >= 100) {
        $satz = 5.0;
    }

    if ($summe >= 500) {
        $satz = 10.0;
    }

    // Zwei Punkte obendrauf, aber nur, wenn es ueberhaupt einen Rabatt gibt.
    if ($satz > 0.0 && $stammkunde) {
        $satz += 2.0;
    }

    return round($summe * $satz / 100, 2);
}

echo "80 Euro, Laufkunde:     ", rabatt(80, false), "\n";
echo "100 Euro, Laufkunde:    ", rabatt(100, false), "\n";
echo "500 Euro, Laufkunde:    ", rabatt(500, false), "\n";
echo "500 Euro, Stammkunde:   ", rabatt(500, true), "\n";
echo "80 Euro, Stammkunde:    ", rabatt(80, true), "\n";

Ob die fünf Zahlen stimmen, siehst du an den Regeln der Funktion. Die sind überschaubar:

  • Unter 100 Euro gibt es keinen Rabatt.
  • Ab 100 Euro sind es 5 Prozent.
  • Ab 500 Euro sind es 10 Prozent.
  • Stammkunden bekommen zwei Prozentpunkte mehr, aber nur, wenn es überhaupt einen Rabatt gibt.

Schwer ist das Nachrechnen nicht, es nutzt sich nur ab. Beim ersten Mal gehst du alle fünf Zeilen durch, beim dritten Mal überfliegst du sie. Beim sechsten Mal, freitags um halb sechs, siehst du auf die erste, denkst „passt schon“ und machst Feierabend.

Die Prüfung hinschreiben statt sie zu denken

Dieselbe Prüfung, aufgeschrieben
<?php

declare(strict_types=1);

function rabatt(float $summe, bool $stammkunde): float
{
    $satz = 0.0;

    if ($summe >= 100) {
        $satz = 5.0;
    }

    if ($summe >= 500) {
        $satz = 10.0;
    }

    // Zwei Punkte obendrauf, aber nur, wenn es ueberhaupt einen Rabatt gibt.
    if ($satz > 0.0 && $stammkunde) {
        $satz += 2.0;
    }

    return round($summe * $satz / 100, 2);
}

// Mehr als das ist ein Test nicht: aufrufen, vergleichen, hinschreiben.
function pruefe(string $name, float $erwartet, float $bekommen): bool
{
    $ok = $erwartet === $bekommen;

    echo $ok ? "ok     " : "FEHLER ", $name, "\n";

    if (!$ok) {
        echo "       erwartet ", $erwartet, ", bekommen ", $bekommen, "\n";
    }

    return $ok;
}

$ergebnisse = [
    pruefe("unter 100 Euro gibt es nichts", 0.0, rabatt(80, false)),
    pruefe("ab 100 Euro sind es 5 Prozent", 5.0, rabatt(100, false)),
    pruefe("ab 500 Euro sind es 10 Prozent", 50.0, rabatt(500, false)),
    pruefe("Stammkunden bekommen zwei Punkte mehr", 60.0, rabatt(500, true)),
    pruefe("ohne Rabatt bringt auch die Treue nichts", 0.0, rabatt(80, true)),
];

$rot = count(array_filter($ergebnisse, fn (bool $ok) => !$ok));

echo "\n", count($ergebnisse), " Fälle, ", $rot, " davon rot\n";

Funktion und Fälle sind dieselben. Neu ist, dass die Erwartung im Code steht. Vorher wusstest du, dass bei 500 Euro für einen Stammkunden 60 herauskommen muss. Jetzt weiß es das Programm.

Viel mehr als pruefe() ist ein Test nicht. Die Funktion bekommt einen Namen, einen erwarteten Wert und den Wert, der wirklich herauskam, vergleicht beide mit === und schreibt eine Zeile. Ihr Rückgabewert sagt, ob es gestimmt hat, und am Ende zählt das Programm die roten Fälle.

Jeder Fall trägt als Namen einen Satz, etwa „ab 500 Euro sind es 10 Prozent“. Im Fehlerfall siehst du damit, welche Regel verletzt ist, und nicht nur, welcher Aufruf. Außerdem stehen dann beide Werte in der Ausgabe, der erwartete und der bekommene.

Bei Kommazahlen ist === heikler, als es hier aussieht. Hier geht es gut, weil round() jedes Ergebnis auf zwei Stellen bringt. Ohne das Runden braucht es einen Vergleich mit etwas Spielraum. PHPUnit hat dafür einen eigenen, und der kommt in der Lektion „Behauptungen“ dran.

Der Tag, an dem sich etwas ändert

Eine Änderung, die etwas anderes kaputt macht
<?php

declare(strict_types=1);

function rabatt(float $summe, bool $stammkunde): float
{
    $satz = 0.0;

    if ($summe >= 100) {
        $satz = 5.0;
    }

    if ($summe >= 500) {
        $satz = 10.0;
    }

    // Neu von heute: die dritte Stufe.
    if ($summe >= 1000) {
        $satz = 15.0;
    }

    if ($stammkunde) {
        $satz += 2.0;
    }

    return round($summe * $satz / 100, 2);
}

function pruefe(string $name, float $erwartet, float $bekommen): bool
{
    $ok = $erwartet === $bekommen;

    echo $ok ? "ok     " : "FEHLER ", $name, "\n";

    if (!$ok) {
        echo "       erwartet ", $erwartet, ", bekommen ", $bekommen, "\n";
    }

    return $ok;
}

$ergebnisse = [
    pruefe("unter 100 Euro gibt es nichts", 0.0, rabatt(80, false)),
    pruefe("ab 100 Euro sind es 5 Prozent", 5.0, rabatt(100, false)),
    pruefe("ab 500 Euro sind es 10 Prozent", 50.0, rabatt(500, false)),
    pruefe("Stammkunden bekommen zwei Punkte mehr", 60.0, rabatt(500, true)),
    pruefe("ohne Rabatt bringt auch die Treue nichts", 0.0, rabatt(80, true)),
];

$rot = count(array_filter($ergebnisse, fn (bool $ok) => !$ok));

echo "\n", count($ergebnisse), " Fälle, ", $rot, " davon rot\n";

Dann kommt eine neue Anforderung. Ab 1000 Euro gibt es 15 Prozent, eigentlich eine harmlose Zeile mehr. Beim Einbauen ist allerdings die Bedingung verlorengegangen, dass der Stammkunden-Bonus einen Rabatt voraussetzt.

Im Terminal stehen vier Fälle auf ok und einer auf FEHLER, mit beiden Werten darunter (erwartet 0, bekommen 1.6). Von Hand hättest du diesen Fall wahrscheinlich gar nicht mehr angesehen, weil du gerade an der 1000er-Regel sitzt und der kaputte Fall mit 1000 Euro nichts zu tun hat. Das ist die Sorte Fehler, die Wochen später als Kundenmail zurückkommt.

Für die neue Regel gibt es in diesem Lauf übrigens keinen Fall. 15 Prozent auf 1200 Euro kommen in keiner der fünf Zeilen vor.

Ändern, ohne zu wetten

Fehler finden Tests auch. Mehr bringen sie, wenn du Code ändern willst, den du nicht mehr im Kopf hast. Ohne Tests ist so eine Änderung eine Wette. Du weißt nicht, was noch daran hängt, also fasst du möglichst wenig an, baust lieber daneben etwas Neues und lässt das Alte stehen. So entstehen die Dateien, die niemand mehr anfassen will.

Mit einer Handvoll Tests wird aus der Wette eine Frage, die in ein paar Sekunden beantwortet ist. Du baust um, lässt die Tests laufen und weißt danach, ob die fünf Rabatte von gestern noch dieselben sind.

Was sich schlecht testen lässt

Eine Funktion, die selbst eine Datenbank öffnet, braucht für jeden Test eine Datenbank. Eine, die date() aufruft, rechnet morgen anders als heute. Und gibt eine Funktion ihr Ergebnis mit echo aus, statt es zurückzugeben, bleibt für pruefe() nichts zum Vergleichen übrig. Die ersten beiden holen sich selbst, was sie genauso gut als Parameter bekommen könnten.

Wie man solche Funktionen umbaut, steht in der Lektion „Testbaren Code schreiben“ in diesem Abschnitt. Bis dahin müsste ein Test ihnen eine Datenbank bauen, die Uhr anhalten oder die Ausgabe abfangen.

Zum Mitnehmen

Ein Test ist ein zweites Stück Code, das dein erstes aufruft und sagt, ob das Ergebnis stimmt, bei jedem Lauf und nicht nur beim ersten. Am meisten bringt er beim Umbauen.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.