Funções são códigos que tem um objetivo específico. As funções podem receber ou não valores (parâmetros), executam uma sequência de códigos, e retonam um valor.

Quando codificamos um sistema, alguns códigos, as vezes tem de ser escritos repetidamente em diversos lugares separados. Esse se torna um problema claro, quando temos que modificar esse trecho de código, e temos que sair alterando os mesmos trechos de códigos que está codificado. E se torna um problema muito maior quando esquecemos de alterar todos os trechos.

Utilizando as funções, escrevemos o trecho de código uma única vez. E onde quisermos usar aquele trecho de código, basta chamar a função.

Um código repetitivo:

<?php
    echo 'Olá, ';
    echo 'Edgar Ferreira da Silva';
    echo ', seja bem vindo ao uso de funções em PHP. Como pode ver ';
    echo 'Edgar Ferreira da Silva';
    echo ', nesse exemplo, imprimimos várias vezes o seu nome. A propósito, ';
    echo 'Edgar Ferreira da Silva';
    echo ', irei imprimir seu nome pela última vez: ';
    echo 'Edgar Ferreira da Silva';

A anatomia de uma função

Identificador: uma função tem que ter um nome. A regra de nomenclatura de uma função é parecida com a regra de nomenclatura de variáveis.

• a declaração de uma função deve começar com a palavra function seguida de um ou mais espaços
• deve ter pelo menos um caractere
• deve começar com _ ou com letras de a-z maíusculas ou minúsculas
• após o primeiro caracter, números são permitidos
• após o nome de uma função deve seguir a abertura de parênteses (
• se houver parâmetros, esses devem seguir, separados por vírgulas, com a denotação de variável
• após os parâmetros deve-se fechar os parênteses )
• após o fechamento dos parênteses deve-se iniciar o bloco de comandos com {
• após a abertura de bloco de comandos escrevemos os códigos da função
• e para finalizar, fechamos o bloco de comandos com }

Seguindo essas regras básicas, podemos montar as funções de várias formas:

function minhaFuncao() {
    //meu código
}

function _minhaFuncao22($parametro) {
    //faz alguma coisa
}

Para o código de exemplo, podemos notar que várias vezes é utilizada a sentença: echo 'Edgar Ferreira da Silva';

Então, podemos deduzir que deveríamos transformar isso em uma função, então declaramos uma função que faça exatamente isso:

function nome() {
    echo 'Edgar Ferreira da Silva';
}

E quando quisermos imprimir o nome simplesmente fazemos a chamada da função.

A chamada consiste na escrita do nome da função, seguido de parênteses (). Se houver parâmetros, eles devem ser inseridos dentro dos parênteses. Então vejamos:

<?php
    echo 'Olá, ';
    nome();
    echo ', seja bem vindo ao uso de funções em PHP. Como pode ver ';
    nome();
    echo ', nesse exemplo, imprimimos várias vezes o seu nome. A propósito, ';
    nome();
    echo ', irei imprimir seu nome pela última vez: ';
    nome();
   
function nome() {
    echo 'Edgar Ferreira da Silva';
}

E o resultado será o mesmo. A vantagem, no exemplo acima, é que se o nome mudar, mudamos apenas em um lugar. Esse exemplo é muito simples, mas as funções são exaustivamente usadas com códigos muito mais complexos.

O retorno de valores

Uma função sempre retorna um valor. Esse valor pode ser uma variável, um dado ou o resultado de uma função quando indicamos o que retornar. Quando não indicamos, o retorno dela sempre será null.

Para retornar um valor, utilizamos a palavra return. Quando o PHP executa o return, ele para a execução da função, ou seja, se dentro da função tiver códigos abaixo do return, eles não serão executados.

<?php
    echo 'Olá, ';
    echo nome();
    echo ', seja bem vindo ao uso de funções em PHP. Como pode ver ';
    echo nome();
    echo ', nesse exemplo, imprimimos várias vezes o seu nome. A propósito, ';
    echo nome();
    echo ', irei imprimir seu nome pela última vez: ';
    echo nome();

function nome() {
    return 'Edgar Ferreira da Silva';
}

A função acima poderia retornar uma variável:

function nome() {
    $nome = 'Edgar Ferreira da Silva';
    return $nome;
}

E qualquer coisa que estiver após o return não será executado:

function nome() {
    $nome = 'Edgar Ferreira da Silva';
    return $nome;
    echo 'Essa frase não será impressa';
}

Importante: Não pode haver duas funções com o mesmo nome, isso gera um erro no PHP.

Há muito mais sobre funções e tudo será explicado nos próximos posts.