Basiswissen

Neben den bereits in die Programmiersprache fertig eingebauten Funktionen kann man in PHP auch eigene Funktionen definieren. Diese kann man dann ganz ähnlich wie Programmierbefehle nutze.

Definition einer Funktion in PHP

function erde_Durchmesser() {
echo "Etwa 12756 Kilometer";
}

Diese Definition wird beim Aufruf den Erddurchmesser in Kilometern anzeigen.

Erde_Durchmesser ist der Name der Funktion

Funktionsnahmen müssen mit einem Buchstaben oder einem Tiefstrich (underscore _) beginnen.^[1]

Es wird nicht zwischen Groß- und Kleinbuchstaben unterschieden:

Erde_Durchmesser und erde_durchmesser sind derselbe Funktionsname.

Die runden Klammern müssen mit enthalten sein.

In den geschweiften Klammern stehen die Anweisungen.

Diese werden beim Aufruf ausgeführt.

Aufruf einer function in PHP

erde_Durchmessser();

Der Name der Funktion direkt gefolgt von runden Klammern startet die Funktion.

Auch hier sind die runden Klammern wichtig.

Eine Zeile in PHP muss immer mit einem Semikolon (;) abgeschlossen werden.

Funktionen mit Parametern in PHP

Die bisher leere Klammer bietet die Möglichkeit, Dinge an die Funktion zu übergeben. Die übergebenen Inhalte nennt man auch Argumente. Das Argument hat die Form einer Variablen, beginnt also mit einem Dollarzeichen. Zuerst wird eine Funktion definiert:

function kisteVolumen($Länge,$Breite,$Höhe) {
echo $Länge*$Breite*$Höhe;
}

Zum Aufruf der Funktion muss man den Variablen erst Werte zuweisen. Dann ruft man die Funktion mit ihrem Namen und den drei übergebenen Variablen auf:

$Länge=10;
$Breite=20;
$Höhe=5;

kisteVolumen($Länge,$Breite,$Höhe);

Die Funktion läuft jetzt im Hintergrund ab und zeigt am Ende das Ergebnis 1000 an. Bei der Übergabe der Variablen oder Konstanten spielt nicht der Name die wichtige Rolle, sondern die Position innerhalb der runden Klammern. Was beim Aufruf an erster Stelle in den runden Klammern steht, wird dem ersten Namen in der runden Klammer innerhalb der Funktion selbst zugeordnet.

Aufruf einer function mit Default-Werten in PHP

Hat das Programm den Variablen noch keinen Wert zugewiesen, so kann die Funktion bei ihrer Definition selbst Standard-Werte, sogenannte Default-Werte einsetzen:

function kisteVolumen($Länge=4,$Breite=5,$Höhe=2) {
echo $Länge*$Breite*$Höhe;
}

Ruft man die Funktion jetzt auf, ohne dass die Variablen irgendwo sonst im Programm mit Werten gefüllt wurden, rechnet die Funktion automatisch mit den Werten 4, 5 und 2 und zeigt das Ergebis 40 an.

Werte zurückgeben mit return in PHP

Zuerst wird eine Funktion definiert, die zwei Zahlen, übergeben in den Variablen $a und $b addiert. Dann wird das Ergebnis in der Variablen $z abgelegt. Die Anweisung return $z sagt, dass die Variable auch außerhalb der Funktion verfügbar ist:

function zahlenAddieren($a,$b) {
$z = $a+$b;
return $z;
}

Jetzt kann man die Funktion mit zwei zu addierenden Zahlen aufrufen, etwa 9 und 4. Dabei immer an das Semikolon am Ende der Zeile denken. Die Funktion zeigt jetzt das Rechenergebnis von $z an, im Beispiel wird das die Zahl 13 sein:

echo zahlenAddieren(9,4);

Feldvariablen zurückgeben mit return in PHP

Einer Funktion in PHP kann man beim Aufruf eine Feldvariable (englisch array) übergeben. Nach Beendigung der Funktion kann der Inhalt der Feldvariablen wieder zurück an das aufrufende Hauptprogramm gegeben werden:

$feld=array(1,2,3,4,5);
print_r(mischeZahlen($feld));

function mischeZahleN($feld) {
shuffle($feld);
return $feld;
}

In dem Beispiel oben hat eine Feldvariable zunächst die Zahlen von 1 bis 5 in aufsteigender Folge gespeichert. In der Funktion mit dem Namen mischeZahlen wird die Reihenfolge der Zahlen zufällig verändert. Diese veränderte Zahlenfolge wird an den aufrufenden Befehl print_r^[2] zurückgegeben und am Bildschirm angezeigt.

Fußnoten

[1] Nicht zwingend nötig, aber als Konvention durchgesetzt hat sich, dass der Name einer Funktion immer mit einem Kleinbuchstaben beginnt. Jedes weitere Wort beginnt dann mit einem Großbuchstaben. Idealerweise ist das erste Wort ein Verb. Damit sagt man, was die Funktion tut. Großbuchstaben im Inneren von Worten nennt man im Deutschen Binnenmajuskel. Im Englischen bezeichnet man die ganze Schreibweise als camelCase. Die gedachten Höcker eines Kamels stehen dabei für die herausragenden Großbuchstaben.

[2] print_r in PHP ist ein Befehl, der unter anderem die Inhalt einer Feldvariablen in für Menschen gut lesbarer Form anzeigt.