return
Wyrażenie return zwraca kontrolę programu do modułu wykonującego.
Wykonywanie wznawiane jest na wyrażeniu następującym po wywołaniu wywoływanego modułu.
Jeżeli użyte wewnątrz funkcji, wyrażenie return
natychmiast kończy wykonanie tej funkcji i
zwraca swój argument jako wartość wywołania
funkcji. return kończy też wykonanie
wyrażeń eval i pliku skryptu.
Jeżeli zostało wywołane z zasięgu globalnego, to kończone jest
wykonanie aktualnego pliku skryptu. Jeżeli obecny zasięg pliku
dołączony za pomocą include lub require,
to kontrola jest przekazywana z powrotem do pliku, który je wykonał. Ponadto, jeśli
obecny skrypt został dołączony przez include, to
wartość podana dla return będzie zwrócona jako
wartość wywołania include. Jeżeli
return jest wywołane w głównym pliku
skryptu, to wykonywanie skryptu kończy się. Jeżeli obecny skrypt był
ustawiony jako opcja auto_prepend_file lub auto_append_file
w &php.ini;
to wykonywanie tego pliku skryptu kończy się.
Aby dowiedzieć się więcej zobacz rozdział Zwracanie wartości.
Zauważ, że jako iż return jest konstrukcją
języka, a nie funkcją, nawiasy okalające jego
argument nie są wymagane, a ich użycie jest niezalecane.
Jeżeli nie podano parametru, to nawiasy muszą zostać pominięte,
a zwrócony zostanie &null;.
Wywołanie return z nawiasami, ale
bez argumentów spowoduje błąd parsowania.
Od PHP 7.1.0 wyrażenia return bez argumentu w funkcjach, które deklarują zwracany typ wywołują E_COMPILE_ERROR,
chyba że zwracanym typem jest void, gdyż w takim wypadku to wyrażenia return
z argumentem wywołują taki błąd.