Abschnitt 6 · Lektion 3
Standardwerte und benannte Argumente
speichere("notiz.txt", true, false, true) ist ein vollständiger Aufruf, und beim Lesen weiß
niemand, welches true wofür steht. Dazu musst du bei jedem Aufruf alle vier Werte hinschreiben,
auch die, die fast immer gleich sind. Dabei sollte die häufigste Art, eine Funktion zu benutzen, die
kürzeste sein.
Ein Parameter darf einen Standardwert haben
<?php
declare(strict_types=1);
function begruesse(string $name, string $gruss = "Hallo", string $zeichen = "!"): string
{
return $gruss . " " . $name . $zeichen;
}
echo begruesse("Mia"), "\n";
echo begruesse("Ben", "Moin"), "\n";
echo begruesse("Tom", "Servus", "."), "\n"; Ein Gleichheitszeichen hinter dem Parameter, dahinter der Standardwert (englisch default value). Das
ist der Wert, der gilt, wenn beim Aufruf nichts dasteht. Damit ist begruesse("Mia") ein
vollständiger Aufruf, obwohl die Funktion drei Parameter hat.
Der Nutzen liegt im Lesen. Im Aufruf steht nur noch, was vom Normalfall abweicht. Liest du
begruesse("Ben", "Moin"), siehst du sofort, dass der Gruß anders ist und alles andere wie immer.
Die Funktion hat trotzdem alle drei Werte. Im Reiter Debug stehen schon beim ersten Aufruf
gruss="Hallo" und zeichen="!" an der return-Zeile, obwohl im Aufruf beides fehlt.
Als Standardwert geht nur, was PHP ohne Funktionsaufruf ausrechnen kann, also eine Zahl, ein Text,
true, null, ein Array aus festen Werten, eine Konstante oder eine kleine Rechnung wie 2 * 21.
Bei einem Funktionsaufruf meldet PHP Constant expression contains invalid operations.
Ein Parameter, der auch fehlen darf, bekommt oft null als Standardwert und dazu das Fragezeichen
vor dem Typ aus der letzten Lektion, ?string $name = null. Ohne das Fragezeichen nimmt PHP 8.2 es
stillschweigend hin. Ab PHP 8.4 steht dann eine Deprecated-Meldung mit
Implicitly marking parameter $name as nullable is deprecated auf dem Fehlerkanal.
Beim Aufruf darfst du die Namen dazuschreiben
<?php
declare(strict_types=1);
function speichere(string $text, bool $ueberschreiben = false, bool $sichern = true, bool $melden = false): string
{
return $text . " [" . ($ueberschreiben ? "überschreiben" : "-")
. ", " . ($sichern ? "sichern" : "-")
. ", " . ($melden ? "melden" : "-") . "]";
}
// Wer weiss beim Lesen, welches true wozu gehoert?
echo speichere("notiz.txt", true, false, true), "\n";
// Dieselbe Wirkung, aber lesbar:
echo speichere("notiz.txt", ueberschreiben: true, sichern: false, melden: true), "\n";
// Und nur das eine, das vom Ueblichen abweicht:
echo speichere("notiz.txt", melden: true), "\n"; Der erste Aufruf im Beispiel ist der vom Anfang. Willst du wissen, welcher Parameter an zweiter Stelle steht und welcher an dritter, musst du zur Funktion hochblättern.
Seit PHP 8 darfst du beim Aufruf den Parameternamen davorschreiben, mit Doppelpunkt. Das heißt benanntes Argument (englisch named argument). Die zweite Zeile tut dasselbe wie die erste, und du kannst sie lesen, ohne irgendwo nachzusehen.
Im dritten Aufruf steht nur noch melden: true. Ein Wert lässt sich mittendrin setzen, und der
Rest bleibt bei seinem Standardwert. Ohne benannte Argumente müsstest du $ueberschreiben und
$sichern noch einmal mit ihrem Standardwert hinschreiben, nur um an $melden heranzukommen.
Solche Zeilen gehen später kaputt, wenn sich ein Standardwert ändert.
Der Parametername gehört damit zur Funktion wie ihr eigener Name. Benennst du einen Parameter um,
bricht jeder Aufruf, der ihn nennt. Ein Name, den es gar nicht gibt, bricht sofort ab, bei
php -r 'function f(int $a) {} f(b: 1);' mit Unknown named parameter $b.
Wo Standardwerte und Namen stehen dürfen
<?php
declare(strict_types=1);
// Ein Standardwert vor einem Pflichtparameter:
function rechne(int $summand = 10, int $faktor): int
{
return $summand * $faktor;
}
echo rechne(3, 4), "\n"; Parameter mit Standardwert stehen hinten. Sonst ließe sich der Standardwert gar nicht weglassen, ohne alle Argumente dahinter mit zu verschieben.
Im Beispiel ist die Reihenfolge absichtlich umgedreht. PHP läuft trotzdem und rechnet 12, meldet
aber auf dem Fehlerkanal Optional parameter $summand declared before required parameter $faktor
und dahinter is implicitly treated as a required parameter. Der Standardwert ist also wirkungslos,
und der Parameter ist in Wahrheit Pflicht. Das ist eine Deprecated-Meldung, und die kündigt an,
dass diese Schreibweise verschwinden wird.
<?php
declare(strict_types=1);
function zeige(int $a, int $b, int $c): string
{
return "$a-$b-$c";
}
// Das geht:
echo zeige(1, b: 2, c: 3), "\n";
// Und das nicht mehr:
echo zeige(a: 1, 2, 3), "\n"; Nach dem ersten benannten Argument brauchen alle folgenden auch einen Namen. Deshalb ist der erste Aufruf im Beispiel erlaubt und der zweite nicht.
Die Ausgabe ist leer. Auch die erste Zeile läuft nicht, denn
Cannot use positional argument after named argument ist ein Fehler beim Einlesen der Datei und
nicht beim Ausführen. Bei der falsch platzierten declare-Zeile aus der letzten Lektion war es
genauso.
In der Aufgabe ist die Funktion schon fertig, gefragt sind nur ihre vier Aufrufe.
Zum Mitnehmen
Ein Standardwert macht einen Parameter beim Aufruf weglassbar, deshalb steht er hinten. Benannte Argumente sagen beim Aufruf, welcher Wert wohin gehört, auch für einen einzigen Wert mitten in der Liste, und nach dem ersten Namen braucht jedes weitere Argument einen.
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 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.