Devolver valores

Los valores son devueltos usando la sentencia opcional return. Se puede devolver cualquier tipo, incluidos arrays y objetos. Esto causa que la función finalice su ejecución inmediatamente y pase el control de nuevo a la línea desde la que fue llamada. Véase return para más información.

Nota:

Si se omite return, el valor devuelto será null.

Empleo de return

Ejemplo #1 Empleo de return

<?php
function cuadrado($núm)
{
return
$núm * $núm;
}
echo
cuadrado(4); // imprime '16'.
?>

Una función no puede devolver múltiples valores, pero se pueden obtener resultados similares devolviendo un array.

Ejemplo #2 Devolver un array para obtener múltiples valores

<?php
function numerosPequeños()
{
return [
0, 1, 2];
}
// La desestructuración arrays recopilará cada miembro del array individualmente.
[$zero, $one, $two] = numerosPequeños();

// Antes de PHP 7.1.0, la única alternativa equivalente era el uso del constructor list()
list($zero, $one, $two) = numerosPequeños();

?>

Para devolver una referencia desde una función use el operador de referencia &, tanto en la declaración de la función y cuando se asigne el valor devuelto a una variable:

Ejemplo #3 Devolver una referencia desde una función

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

$nuevaref =& devolver_referencia();
?>

Para más información sobre referencias, por favor, lea las Referencias explicadas.