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 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.