Retornando Valores

As funções que criamos até agora usam echo para exibir a saída diretamente. Mas muitas vezes, você quer que uma função calcule algo e retorne o resultado para você, para que possa usá-lo em outro lugar no seu código. É aqui que entra a instrução return.

A instrução return envia um valor de volta para onde a função foi chamada:

<?php
function add($a, $b) {
    return $a + $b;
}

$result = add(5, 3);
echo $result;
?>

Isso exibe 8. Em vez de imprimir a soma dentro da função, nós a retornamos. O código chamador recebe esse valor e o armazena em $result.

Retornar valores torna as funções muito mais versáteis. Você pode usar o valor retornado em cálculos, passá-lo para outras funções ou armazená-lo para uso posterior:

<?php
function double($num) {
    return $num * 2;
}

echo double(5) + double(3);
?>

Isso produz 16 (10 + 6). Cada chamada para double() retorna um valor que é usado na adição.

Uma coisa importante a saber: quando o PHP encontra uma instrução return, a função para imediatamente. Qualquer código após return não será executado.