Функции в PHP

Возвращаемые значения

Все функции, приведенные выше в качестве примеров, выполняли какие-либо действия. Кроме подобных действий, любая функция может возвращать как результат своей работы какое-нибудь значение. Это делается с помощью утверждения return. Возвращаемое значение может быть любого типа, включая списки и объекты. Когда интерпретатор встречает команду return в теле функции, он немедленно прекращает ее исполнение и переходит на ту строку, из которой была вызвана функция.

Например, составим функцию, которая возвращает возраст человека. Если человек не умер, то возраст считается относительно текущего года.

<?php
/* если второй параметр вычисляется 
как true, то он рассматривается как 
дата смерти, */

function Age($birth, $is_dead){
  if ($is_dead) return $is_dead-$birth;
  else return date("Y")-$birth;
}
echo Age(1971, false); // для 2009 года выведет 38
echo Age(1971, 2001); // выведет 30
?>

В этом примере можно было и не использовать функцию return, а просто заменить ее функцией вывода echo. Однако если мы все же делаем так, что функция возвращает какое-то значение (в данном случае возраст человека), то в программе мы можем присвоить любой переменной значение этой функции:

$an_age = Age(1981, 2004);

В результате работы функции может быть возвращено только одно значение. Несколько значений можно получить, если возвращать список значений (одномерный массив). Допустим, мы хотим получить полный возраст человека с точностью до дня.

<?php
function Full_age($b_day, $b_month, $b_year)
{
        $y = date("Y");
        $m = intval(date("m"));
        $d = intval(date("d"));
        $b_month = intval($b_month);
        $b_day = intval($b_day);
        $b_year = intval($b_year);

        $day = ($b_day > $d ? 30 - $b_day + $d : $d - $b_day);
        $tmpMonth = ($b_day > $d ?  -1 : 0);
        $month = ($b_month > $m + $tmpMonth ? 12 - $b_month + 
          $tmpMonth + $m : $m+$tmpMonth - $b_month);
        $tmpYear  = ($b_month >  $m + $tmpMonth ?  -1 : 0);
        if ($b_year > $y + $tmpYear)
        {
                $year = 0; $month = 0; $day = 0;
        }
        else
        {
                $year = $y + $tmpYear - $b_year;
        }
        return array ($day,$month,$year);
}
$age = Full_age("29","06","1986");
echo "Вам $age[2] лет, $age[1] месяцев и $age[0] дней";
?>

Когда функция возвращает несколько значений для их обработки в программе, удобно использовать языковую конструкцию list (), которая позволяет одним действием присвоить значения сразу нескольким переменным. Например, в предыдущем примере, оставив без изменения функцию, обработать возвращаемые ей значения можно было так:

<?
// задание функции Full_age()
list($day,$month,$year) = Full_age("07",
    "08","1974");
echo "Вам $year лет, $month месяцев и 
    $day дней";
?>

Вообще конструкцию list () можно использовать для присвоения переменным значений элементов любого массива.

<?
$arr = array("first","second");
list($a,$b) = $arr; 
   // переменной $a присваивается первое
   // значение массива, $b – второе
echo $a," ",$b;     
   // выведет строку "first second"
?>

Возвращение ссылки

В результате своей работы функция также может возвращать ссылку на какую-либо переменную. Это может пригодиться, если требуется использовать функцию для того, чтобы определить, какой переменной должна быть присвоена ссылка. Чтобы получить из функции ссылку, нужно при объявлении перед ее именем написать знак амперсанд ( & ) и каждый раз при вызове функции перед ее именем тоже писать амперсанд ( & ). Обычно функция возвращает ссылку на какую-либо глобальную переменную (или ее часть – ссылку на элемент глобального массива), ссылку на статическую переменную (или ее часть) или ссылку на один из аргументов, если он был также передан по ссылке.

<?
$a = 3; $b = 2;
function & ref($par){
global $a, $b;
  if ($par % 2 == 0) return $b;
  else return $a;
}
$var =& ref(4);
echo $var, " и ", $b,"<br>"; 
   //выведет 2 и 2
$b = 10;
echo $var, " и ", $b,"<br>"; 
   // выведет 10 и 10
?>

При использовании синтаксиса ссылок в переменную $var нашего примера не копируется значение переменной $b возвращенной функцией $ref, а создается ссылка на эту переменную. То есть теперь переменные $var и $b идентичны и будут изменяться одновременно.