Instrucțiunea return în PHP

Să presupunem că avem o funcție care afișează pe ecran pătratul numărului transmis:

php<?php
  function func($num) {
    echo $num * $num;
  }
  
  func(3); // va afișa 9
?>

Să presupunem că vrem să nu afișăm valoarea pe ecran, ci să o scriem într-o variabilă, astfel:

php<?php
  $res = func(3); // în variabila $res este acum 9
?>

Pentru aceasta, în PHP există o instrucțiune specială return, care permite să se indice valoarea pe care o returnează funcția. Prin cuvântul returnează se înțelege valoarea care se va scrie în variabilă, dacă funcția apelată i se atribuie.

Deci, să rescriem funcția noastră astfel încât ea să nu mai afișeze rezultatul pe ecran, ci să îl returneze în variabilă:

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

Să scriem acum rezultatul funcției într-o variabilă:

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

După ce datele sunt scrise în variabilă, ele pot fi, de exemplu, afișate pe ecran:

php<?php
  $res = func(3);
  echo $res; // va afișa 9
?>

Sau se pot modifica mai întâi cumva aceste date, și apoi să le afișăm pe ecran:

php<?php
  $res = func(3);
  $res = $res + 1;
  echo $res; // va afișa 10
?>

Se pot efectua imediat acțiuni cu rezultatul funcției înainte de scrierea în variabilă:

php<?php
  $res = func(3) + 1;
  echo $res; // va afișa 10
?>

Putem apela funcția noastră de mai multe ori pentru numere diferite:

php<?php
  $res = func(2) + func(3);
  echo $res; // va afișa 13
?>

Putem să nu scriem rezultatul într-o variabilă, ci să îl afișăm imediat pe ecran:

php<?php
  echo func(3); // va afișa 9
?>