Инструкция return в PHP

Да предположим, че имаме функция, която извежда на екрана квадрата на подаденото число:

php<?php
  function func($num) {
    echo $num * $num;
  }
  
  func(3); // ще изведе 9
?>

Да предположим, че искаме не да извеждаме стойността на екрана, а да я запишем в някаква променлива, ето така:

php<?php
  $res = func(3); // в променливата $res сега е 9
?>

За това в PHP съществува специална инструкция return, която позволява да се укаже стойността, която функцията връща. Под думата връща се разбира стойността, която ще се запише в променливата, ако ѝ се присвои извиканата функция.

И така, нека пренапишем нашата функция така, че да не извежда резултата на екрана, а да го връща в променлива:

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

Нека сега запишем резултата от работата на функцията в променлива:

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

След като данните са записани в променлива, те могат, например, да бъдат изведени на екрана:

php<?php
  $res = func(3);
  echo $res; // ще изведе 9
?>

Може първо да се променят тези данни по някакъв начин, а след това да се изведат на екрана:

php<?php
  $res = func(3);
  $res = $res + 1;
  echo $res; // ще изведе 10
?>

Може веднага да се извършват някакви действия с резултата от работата на функцията преди записването му в променлива:

php<?php
  $res = func(3) + 1;
  echo $res; // ще изведе 10
?>

Може да се извика нашата функция няколко пъти за различни числа:

php<?php
  $res = func(2) + func(3);
  echo $res; // ще изведе 13
?>

Може резултатът да не се записва в променлива, а веднага да се изведе на екрана:

php<?php
  echo func(3); // ще изведе 9
?>