Abschnitt 6 · Lektion 2
Typen an Funktionen
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
<?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
<?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
<?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
<?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
<?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, kostenlosZu 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.