Aprenda a retornar valores de funções no PHP corretamente

Como retornar valores de funções no PHP

A instrução return no PHP é utilizada para retornar um valor de uma função, permitindo que o resultado seja utilizado posteriormente no código. O uso correto do return melhora a modularização e reutilização do código.

Exemplo básico de return em funções

<?php
function soma($a, $b) {
    return $a + $b;
}
$resultado = soma(5, 3);
echo "O resultado da soma é: $resultado";
?>

Aqui, a função soma() retorna a soma de dois números. O valor retornado é armazenado na variável $resultado e exibido na tela.

Retornando diferentes tipos de valores

Funções podem retornar diversos tipos de dados, como strings, arrays e booleanos:

<?php
function mensagem() {
    return "Olá, mundo!";
}
echo mensagem();
?>

Este código retorna uma string e a exibe ao chamar a função.

<?php
function obterUsuario() {
    return ["nome" => "Carlos", "idade" => 30];
}
$usuario = obterUsuario();
echo "Nome: ".$usuario["nome"];
?>

Aqui, a função retorna um array associativo contendo informações de um usuário.

Por que utilizar return em funções no PHP?

Retornar valores de funções no PHP permite criar códigos mais organizados e reutilizáveis. Em vez de exibir valores diretamente dentro da função, o uso de return possibilita que os dados sejam manipulados e utilizados em diferentes partes do código. Funções bem estruturadas melhoram a manutenção e evitam duplicação de código, tornando os sistemas mais eficientes.

Algumas aplicações:

• Executar cálculos e reutilizar os resultados
• Retornar dados de consultas em bancos de dados
• Gerar valores dinâmicos para diferentes partes da aplicação
• Facilitar testes unitários ao retornar valores previsíveis

Dicas para quem está começando

• Sempre utilize return quando precisar reutilizar valores de uma função.
• Funções podem retornar qualquer tipo de dado, incluindo arrays e objetos.
• Se uma função não tiver um return, seu valor de retorno será NULL por padrão.
• Para encerrar a execução de uma função antes do final, use return sem valor.
• Evite retornos múltiplos desnecessários para manter a legibilidade do código.

Compartilhe este tutorial