Como criar funções em PHP

Por: Angelo Luis Ferreira | 01/03/2018 Acessos: 8.690

Neste tutorial, vamos mostrar como criar funções próprias em PHP. Este recurso é um dos principais métodos para garantir a reutilização de códigos nos documentos PHP, tornando a programação mais prática e muito mais organizada.

Funções PHP são utilizadas para criar pequenos blocos de códigos independentes. Esses blocos podem gerar um resultado (funções com retorno) ou apenas executar uma rotina (funções sem retorno). Sua principal vantagem é condensar um trecho de códigos e torná-lo reutilizável em vários pontos diferentes do documento.

Funções definidas pelo usuário

1. Para criar funções em PHP utilizamos a palavra-chave function, onde definimos um nome para esta função. Veja a sintaxe abaixo:

function nomeDaFuncao(parâmetros){ 
     
       // instruções
} 

Obs 1: O nome escolhido para a sua função não pode ter espaços, caracteres especiais e nem começar com um número.

Obs 2: Você pode adicionar quantos parâmetros (argumentos) quiser, desde que cada um esteja separado por vírgula e que não tenham a mesma denominação.

Obs 3: Parâmetros devem ter as mesmas características de uma variável.

2. Mesmo se não utilizarmos parâmetros em nossa função, deve haver o parênteses. Neste caso, essa seria a forma correta sem parâmetros:

function nomeDaFuncao() { 
     
       // instruções
} 

Funções sem retorno

Funções sem retorno são ideais pra criar pequenos blocos de código que poderão ser repetidos várias vezes no documento.

1.1. Exemplo de função sem retorno e sem parâmetros (ou argumentos):

function ola () {
    echo "Olá!\n";
    echo "Sejam Bem Vindos!";
}

echo ola();

Para verificar os códigos acima, teste: PHP Squids Editor. Clique no botão [Run] para ver o resultado.

1.2. Exemplo de função sem retorno e com parâmetros (ou argumentos):

function ola($nome, $idade) {
    echo "Olá!\n
";
    echo "Meu nome é ".$nome." e tenho ".$idade." anos.";
}

echo ola('Angelo', "32"); 

Para verificar os códigos acima, teste: PHP Squids Editor. Clique no botão [Run] para ver o resultado.

Atenção: Cuidado para utilizar funções sem retorno usando "echo". Veja o exemplo abaixo:

<?php

function ola () {
 echo "Sejam Bem Vindos!";
}

echo " Olá, tudo bem? ".ola();

Observe que o resultado mostra primeiro os valores da função ola() e depois a string "Olá, tudo bem?".

Para resolver isso, utilize return para retornar a string "Sejam Bem Vindos". Veja a seguir como utilizar funções com return.

Funções com retorno

Funções com retorno são criadas da mesma forma que as funções sem retorno. A diferença é que esta função retorna um resultado através da palavra chave return.

1.1. Exemplo de função com retorno e sem parâmetros (ou argumentos):

function ola() {
    
    return 'Olá, Sejam bem vindos!';
}

$mensagem = ola();
echo $mensagem;

Para verificar os códigos acima, teste:  PHP Squids Editor. Clique no botão [Run - F9] para ver o resultado. 

1.2. Mais um exemplo de função com retorno e sem parâmetros (ou argumentos):

function soma() {

 return 150-125;
}

echo soma();

Para verificar os códigos acima, teste: PHP Squids Editor. Clique no botão [Run] para ver o resultado.

1.3. Exemplo de função com retorno e com parâmetros (argumentos):

function soma($x, $y, $z) {
    
    return ($x - $y) * $z;
}

echo soma(150, 125, 100); 

Para verificar os códigos acima, teste: PHP Squids Editor. Clique no botão [Run] para ver o resultado. 

Documentação Oficial

1. [Funções definidas pelo usuário] » Sobre criação e exemplos de 'funções próprias'.

2. [Função return] » Usada pra retornar valores para fora da função.