mitmario.dev

Typen an Funktionen

PHP Sandbox 4 Min Lesezeit 5 BeispieleLektion 2 von 8

Gibst du einer Funktion einen Preis als Text, bekommst du in PHP meistens trotzdem das richtige Ergebnis. Bei einem Preis mit deutschem Komma kommt aber ein falsches heraus, und niemand merkt es. Deshalb kannst du an eine Funktion hinschreiben, was hineingehört und was herauskommt, und zwar mit einer Typangabe (englisch type declaration) vor jedem Parameter und hinter der Klammer für die Rückgabe. Ob PHP sich daran hält, ist allerdings eine zweite Frage.

Ohne Typen wird alles irgendwie passend gemacht

Ohne Typen rechnet PHP einfach weiter
<?php

function rabatt($preis, $prozent)
{
    return $preis - $preis * $prozent / 100;
}

echo number_format(rabatt("24.99", "20"), 2), "\n";
echo number_format(rabatt("59.90", "10"), 2), "\n";

// Und jetzt ein Preis mit deutschem Komma:
echo number_format(rabatt("12,50", "50"), 2), "\n";

Alle drei Aufrufe liefern eine Zahl, und das Programm endet mit dem Exit-Code 0. Die dritte Zeile stimmt trotzdem nicht. Aus 12,50 mit deutschem Komma wird 6.00 statt 6.25.

PHP hat aus dem Text so viel Zahl gemacht, wie vorne draufstand, also 12, und den Rest weggeworfen. Auf dem Fehlerkanal steht dazu zweimal A non-numeric value encountered. Die Ausgabe sieht trotzdem völlig in Ordnung aus.

Was in der Funktion wirklich ankommt, siehst du nach Aufzeichnen im Reiter Debug. An der return-Zeile steht dreimal ein Preis in Anführungszeichen, preis="24.99", preis="59.90" und preis="12,50", also Text und keine Zahl.

Das ist eine Warnung in ihrer teuersten Form. Die Rechnung ist falsch und fühlt sich nicht so an. Auf einer echten Seite wäre das ein Preis, den niemand nachrechnet.

Ein Typ macht daraus einen Abbruch

Mit Typen wird der Fehler laut
<?php

// Getypt, aber ohne die Zeile mit strict_types:
function rabatt(float $preis, int $prozent): float
{
    return $preis - $preis * $prozent / 100;
}

// Eine saubere Zahl in Anfuehrungszeichen wird umgewandelt:
var_dump(rabatt("24.99", "20"));

// Diese hier ist keine saubere Zahl, und jetzt bricht es ab:
var_dump(rabatt("12,50", 50));

echo "Diese Zeile wird nie erreicht.\n";

Jetzt steht float vor $preis, int vor $prozent und : float hinter der Klammer. Diese erste Zeile mit dem Namen, den Parametern samt Typen und dem Rückgabetyp heißt die Signatur (englisch signature) der Funktion.

Der erste Aufruf geht weiterhin durch. "24.99" ist eine saubere Zahl in Anführungszeichen, und PHP wandelt sie stillschweigend um. Im Reiter Debug steht an der return-Zeile jetzt preis=24.99 ohne Anführungszeichen, aus dem Text ist eine Zahl geworden.

Der zweite Aufruf bricht dagegen ab, mit einem TypeError und der 255 hinter php index.php; echo $?. "12,50" ist eben keine saubere Zahl, und bei einem Typ ist damit Schluss. Die letzte Zeile wird nie erreicht, und in der Meldung steht die Stelle, an der es passiert ist.

float(19.991999999999997) in der ersten Zeile ist 19,992, so genau, wie eine Kommazahl es speichern kann. Das ist der Rundungsfehler aus Abschnitt 2, und number_format rundet ihn bei der Ausgabe weg.

Strenge Typen mit declare

Strikt heißt gar keine Umwandlung
<?php

declare(strict_types=1);

function rabatt(float $preis, int $prozent): float
{
    return $preis - $preis * $prozent / 100;
}

// Echte Zahlen, kein Problem:
var_dump(rabatt(24.99, 20));
var_dump(rabatt(12.50, 50));

// Dieselbe Zahl in Anfuehrungszeichen ist jetzt ein Fehler:
var_dump(rabatt("24.99", 20));

declare(strict_types=1); schaltet die stillschweigende Umwandlung für diese Datei ab. Danach ist auch "24.99" ein Fehler, obwohl es sich rechnen ließe. Wo eine Zahl verlangt ist, kommt nur noch eine Zahl an.

Ab dieser Lektion steht die Zeile in jeder Datei dieses Kurses, die mit <?php anfängt. Ohne sie ist ein Typ eine Empfehlung, die PHP im Zweifel umgeht, und beim Lesen weiß niemand, was wirklich ankommt. Mit ihr ist er eine Zusage, auf die du dich verlassen kannst. Dafür steht er ja da.

Dafür müssen die Aufrufe stimmen. Statt "24.99" steht dann 24.99 im Aufruf, und das ist die Arbeit, die vorher niemand gemacht hat.

Sie muss wirklich ganz oben stehen

Die erste Zeile muss wirklich die erste sein
<?php

echo "Erst etwas anderes\n";

declare(strict_types=1);

echo "Und danach\n";

Die Ausgabe bleibt komplett leer. Nicht einmal das echo von oben läuft.

declare(strict_types=1); muss die erste Anweisung der Datei sein. Steht davor irgendetwas anderes, meldet PHP strict_types declaration must be the very first statement in the script. Das passiert schon beim Einlesen und nicht erst beim Ausführen. Es ist derselbe Fall wie ein Parse-Fehler, und das Programm startet gar nicht erst.

Erlaubt sind davor nur der PHP-Tag <?php ganz am Anfang der Datei und dahinter Leerzeilen und Kommentare. Ein echo, ein include oder eine Zuweisung nicht.

Oder null, oder gar nichts

Vielleicht eine Zahl, vielleicht nichts
<?php

declare(strict_types=1);

function alterVon(string $name): ?int
{
    $liste = ["Mia" => 34, "Ben" => 17];
    return $liste[$name] ?? null;
}

var_dump(alterVon("Mia"));
var_dump(alterVon("Tom"));

function melde(string $text): void
{
    echo $text, "\n";
}

var_dump(melde("fertig"));

// Eine ganze Zahl darf auch strikt an ein float:
function haelfte(float $z): float
{
    return $z / 2;
}

var_dump(haelfte(9));

Das Fragezeichen vor einem Typ heißt „oder null“. ?int heißt also, dass eine ganze Zahl zurückkommt oder eben nichts, weil es den Namen nicht gab. Ohne das Fragezeichen wäre die zweite Zeile ein TypeError, und das ist gut so, denn dann müsstest du dich entscheiden.

void heißt „gibt nichts zurück“. So eine Funktion tut etwas, statt etwas zu liefern. var_dump zeigt dir trotzdem NULL, den Wert, den jede Funktion ohne return liefert. Ein return mit einem Wert wäre in einer void-Funktion ein Fehler.

In der letzten Zeile steht die einzige Umwandlung, die auch strikt erlaubt bleibt. Eine ganze Zahl darf an einen float-Parameter und wird dort zur Kommazahl. Andersherum geht es nicht, auch nicht mit 10.0. Union-Typen wie array|false gibt es auch. Ein Strich zwischen zwei Typen heißt „das eine oder das andere“, und der erste davon begegnet dir in Abschnitt 7.

Im Reiter Praxis bekommt eine Funktion, die ihre Preise als Text annimmt, Typen und die Zeile mit strict_types.

Zum Mitnehmen

Typangaben an Parametern und Rückgabe sagen, was in eine Funktion hinein- und was herausgeht. Ohne declare(strict_types=1) wandelt PHP saubere Zahlen in Anführungszeichen still um, mit der Zeile ist das ein TypeError, und sie muss die erste Anweisung der Datei sein.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

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 5 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.