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