Los valores de retorno

Los valores son devueltos utilizando una instrucción de retorno opcional. Todos los tipos de variables pueden ser devueltos, incluyendo arrays y objetos. Esto hace que la función termine su ejecución inmediatamente y pase el control a la línea llamante. Ver return para más información.

Nota:
Si return es omitido, el valor null será devuelto.

Uso de return

Ejemplo #1 Uso de return

<?php
function cuadrado($num)
{
    return $num * $num;
}
echo cuadrado(4); // Muestra '16'
?>

Una función no puede devolver varios valores a la vez, pero puede obtenerse el mismo resultado devolviendo un array.

Ejemplo #2 Devolver un array de una función

<?php
function pequeño_numero()
{
    return [0, 1, 2];
}
// La descomposición de un array recolectará cada miembro del array individualmente
[$zero, $one, $two] = pequeño_numero();

// Anterior a PHP 7.1, la única alternativa equivalente es utilizando la estructura de lenguaje list()
list ($zero, $un, $deux) = pequeño_numero();
?>

Para devolver una referencia de una función, utilice el operador & tanto en la declaración de la función como en la asignación del valor de retorno.

Ejemplo #3 Devolver una referencia de una función

<?php
function &devolver_referencia()
{
    return $uneref;
}

$newref =& devolver_referencia();
?>

Para más información sobre referencias, véase la explicación sobre referencias.