Como Criar Funções em PHP: Parâmetros, Argumentos e Retorno Prático

 

Até agora, nos exemplos de nossa apostila de PHP, escrevemos blocos de códigos que rodam de forma linear. Mas no mundo real do desenvolvimento web, repetir código é um pecado capital. É aqui que entram as Funções. Nesta aula, você vai aprender a isolar blocos de lógica reaproveitáveis e dominar três conceitos fundamentais: parâmetros, argumentos e o comando de retorno (return).

Parâmetro vs. Argumento: Qual é a diferença?

Embora pareçam sinônimos, há uma diferença clara na programação: o parâmetro é a variável declarada na assinatura da função (o molde). O argumento é o dado real que você envia para dentro dessa função no momento em que a executa.

Para fixar a ideia, pense nas funções nativas que você já usou. Quando chamamos o comando print(), nós colocamos uma informação entre os parênteses:

<?php
   print("Apostila PHP Progressivo");
?>

Neste caso, "Apostila PHP Progressivo" é o argumento (o dado real) que passamos para a função, preenchendo o parâmetro (a vaga reservada) que ela espera receber.

Outro ótimo exemplo é a função matemática nativa pow(), que calcula a potência de um número. Ela necessita obrigatoriamente de dois parâmetros: a base e o expoente.

<?php
   echo "3 elevado a 4 é igual a: " . pow(3, 4);
?>

Aqui, os números 3 e 4 são os argumentos enviados para que a função execute o cálculo interno.

O que é o Retorno de uma Função?

Uma função funciona como uma máquina de processamento. Você insere a matéria-prima (argumentos), a máquina trabalha isolada e devolve o produto final. Essa devolução é o que chamamos de Retorno.

Por exemplo, por trás dos panos do PHP, a função pow(3, 4) executa laços matemáticos complexos. Quando ela termina a conta, ela gera o resultado 81 e o ejeta de volta exatamente no local onde a função foi chamada. É por isso que o comando echo consegue imprimir o resultado na tela.

Exemplo Prático 1: Criando uma Função de Soma

Vamos construir nossa própria função chamada soma(). Ela receberá duas variáveis como parâmetros ($a e $b), fará o cálculo e usará a palavra reservada return para devolver o valor final.

Veja abaixo o script completo integrado a um formulário HTML estruturado:

<html>
 <head>
  <title>Somador Dinâmico em PHP - PHP Progressivo</title>
  <style>
    body { font-family: sans-serif; padding: 20px; color: #334155; }
    .painel { background: #f8fafc; padding: 20px; border: 1px solid #e2e8f0; border-radius: 8px; max-width: 350px; }
    input[type=number] { width: 100%; padding: 6px; margin: 8px 0 15px 0; box-sizing: border-box; }
    input[type=submit] { background: #ea580c; color: white; border: none; padding: 8px 15px; border-radius: 4px; cursor: pointer; }
  </style>
 </head>
 <body>

  <div class="painel">
    <h3>Super Somador</h3>
    <form action="" method="get">
      <label>Número 1:</label>
      <input type="number" name="a" required />
      <label>Número 2:</label>
      <input type="number" name="b" required />
      <input type="submit" value="Calcular Soma" />
    </form>
  </div>
  
  <br>

 <?php
  // Só executa o código se os parâmetros via URL existirem
  if(isset($_GET['a']) && isset($_GET['b'])){
      $a = floatval($_GET['a']);
      $b = floatval($_GET['b']);
      
      // Chamando a função e passando as variáveis como argumentos
      $resultado = soma($a, $b);
      
      echo "<strong>Resultado do Processamento:</strong><br />";
      echo "A soma de $a + $b é igual a: " . $resultado;
  }

  // Declaração da nossa função customizada
  function soma($a, $b){
    $soma_interna = $a + $b;
    return $soma_interna; // Retorna o valor calculado para fora da função
  }
 ?>
 
 </body>
</html>

📚 Cansado de depender de tutoriais picados na internet?

Aprender lógica de funções sem um roteiro estruturado cria lacunas no seu conhecimento que vão cobrar o preço mais tarde em testes de entrevista. A Apostila PHP Progressivo organiza tudo em ordem cronológica de aprendizado com códigos revisados e limpos. Vale a pena ter o material de consulta definitiva salvo no seu computador.

Exemplo Prático 2: Função para Calcular Fatorial

Vamos subir o nível técnico. Lembra de quando ensinamos a calcular o fatorial com laços de repetição? Agora vamos encapsular toda aquela lógica dentro de uma função reaproveitável chamada fat().

<html>
 <head>
  <title>Calculadora de Fatorial Funcional - PHP Progressivo</title>
  <style>
    body { font-family: sans-serif; padding: 20px; color: #334155; }
    .bloco-fatorial { background: #f0fdf4; padding: 20px; border: 1px solid #bbf7d0; border-radius: 8px; max-width: 350px; }
    input[type=number] { width: 100%; padding: 6px; margin: 8px 0 15px 0; }
    input[type=submit] { background: #16a34a; color: white; border: none; padding: 8px 15px; border-radius: 4px; cursor: pointer; }
  </style>
 </head>
 <body>

  <div class="bloco-fatorial">
    <h3>Cálculo de Fatorial</h3>
    <form action="" method="get">
      <label>Calcular o fatorial de:</label>
      <input type="number" name="number" min="0" required />
      <input type="submit" value="Calcular" />
    </form>
  </div>
  
  <br>

 <?php
  if(isset($_GET['number'])){
      $n = intval($_GET['number']);
      
      // Chamando a função e exibindo seu retorno diretamente na tela
      echo "<h4>O fatorial de $n é: " . fat($n) . "</h4>";
  }
  
  // Função que encapsula o laço while de cálculo matemático
  function fat($n){
   $fatorial = 1;
   $count = 1;
     
   while($count <= $n){
     $fatorial *= $count;
     $count++;
   } 
   
   return $fatorial; // Retorna o valor acumulado final
  }
 ?::
 </body>
</html>

🚀 Invista no seu Futuro como Programador Web

"Entender a diferença entre parâmetros e o fluxo do return mudou meu jogo. Parei de copiar códigos e comecei a desenhar arquiteturas simples em PHP de cabeça graças a esse material explicativo."
— Mariana Costa, Analista de Sistemas.

Tenha em mãos o guia definitivo em PDF com toda a lógica explicada, diagramas conceituais e gabarito completo para estudo focado offline.

Apostila Completa de PHP PDF Download
Baixar Apostila Completa em PDF 📥

📚 Próximos Passos de Estudo:

Para solidificar sua base e entender como manipular esses escopos de forma avançada, leia estas aulas:

  • ENTENDENDO O ESCOPO DAS FUNCOES - Descubra o isolamento de variáveis dentro da função.
  • PASSAGEM POR REFERENCIA PHP - Aprenda a alterar variáveis externas usando o operador &.
  • Voltar para o Índice do Curso de PHP

Quer acelerar o aprendizado em múltiplas linguagens?

Leve o pacote com todos os cursos completos: PHP, Java, C, JavaScript, HTML e CSS.

Baixar Mega Pack de Apostilas de Programação

Nenhum comentário: