return

(PHP 4, PHP 5, PHP 7)

return gibt die Programmsteuerung an das aufrufende Modul zurück. Die Ausführung wird mit dem Ausdruck fortgesetzt, die dem Aufruf des aufgerufenden Moduls folgt.

Wenn innerhalb einer Funktion aufgerufen, beendet return augenblicklich die Ausführung der Funktion und übergibt den Parameter als Rückgabewert der Funktion. return beendet ebenfalls die Ausführung von Code innerhalb von eval() oder einer Datei.

Wenn im globalen Raum aufgerufen, endet die Ausführung des Skripts. Wenn das aktuelle Skript mit include oder require eingebunden ist, endet nur die Ausführung der eingebundenen Datei und der Wert, der an return übergeben wurde, wird zum Rückgabewert des Aufrufs von include/require. Wenn return im Hauptskript aufgerufen wird, endet das gesamte Skript. Wenn das aktuelle Skript durch die Konfigurationsdirektiven auto_prepend_file oder auto_append_file aufgerufen wurde, wird die Ausführung dieses Skripts beendet.

Für mehr Informationen, siehe die Dokumentation zu Rückgabewerten.

Hinweis: Weil return ein Sprachkonstrukt und keine Funktion ist, sind die Klammern um das Argument optional. Es ist üblich, sie auszulassen, und dies wird ausdrücklich empfohlen, weil PHP in diesem Fall weniger zu tun hat.

Hinweis: Wenn kein Parameter übergeben wird, dürfen die Klammern nicht gesetzt werden und NULL wird zurückgegeben. Der Aufruf von return mit Klammern aber ohne Parameter verursacht einen Parse Error.

Hinweis: Das Zurückgeben von Referenzen funktioniert nicht, wenn Klammern um den Parameter verwendet werden. Bei return ($a); wird nicht die Variable $a sondern das Ergebnis des Ausdrucks ($a) zurückgegeben (was selbstverständlich der Wert von $a ist).