Инструкция 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
?>