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:
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 al mismo tiempo, pero se puede obtener el mismo resultado devolviendo un array.
Ejemplo #2 Devolver un array de una función
<?php
function numero_pequeno()
{
return [0, 1, 2];
}
// La descomposición de un array recogerá cada miembro del array individualmente
[$cero, $uno, $dos] = numero_pequeno();
// Anterior a PHP 7.1, la única alternativa equivalente es utilizando la estructura de lenguaje list()
list ($cero, $uno, $dos) = numero_pequeno();
?>
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 las referencias, refiérase a la explicación sobre las referencias.