Instrukcja return w PHP

Załóżmy, że mamy funkcję, która wyświetla na ekranie kwadrat przekazanej liczby:

php<?php
  function func($num) {
    echo $num * $num;
  }
  
  func(3); // wyświetli 9
?>

Załóżmy, że chcemy nie wyświetlać wartości na ekran, a zapisać ją w jakiejś zmiennej, w ten sposób:

php<?php
  $res = func(3); // w zmiennej $res jest teraz 9
?>

W tym celu w PHP istnieje specjalna instrukcja return, która pozwala określić wartość, którą zwraca funkcja. Przez słowo zwraca rozumie się tę wartość, która zapisze się w zmiennej, jeśli przypiszemy do niej wywołaną funkcję.

A więc, przepiszmy naszą funkcję tak, aby nie wyświetlała wyniku na ekran, a zwracała go do zmiennej:

php<?php
  function func($num) {
    return $num * $num;
  }
?>

Zapiszmy teraz wynik działania funkcji w zmiennej:

php<?php
  $res = func(3);
?>

Po tym, jak dane są zapisane w zmiennej, można je, na przykład, wyświetlić na ekranie:

php<?php
  $res = func(3);
  echo $res; // wyświetli 9
?>

Można najpierw w jakiś sposób zmodyfikować te dane, a następnie wyświetlić je na ekranie:

php<?php
  $res = func(3);
  $res = $res + 1;
  echo $res; // wyświetli 10
?>

Można od razu wykonywać jakieś działania z wynikiem działania funkcji przed zapisaniem go do zmiennej:

php<?php
  $res = func(3) + 1;
  echo $res; // wyświetli 10
?>

Można wywołać naszą funkcję kilka razy dla różnych liczb:

php<?php
  $res = func(2) + func(3);
  echo $res; // wyświetli 13
?>

Można nie zapisywać wyniku do zmiennej, a od razu wyświetlić go na ekranie:

php<?php
  echo func(3); // wyświetli 9
?>