Function PHP: Como usar funções em PHP para reutilizar códigos

Uma função em PHP (function PHP) permite a invocação e a execução do mesmo blocos de código infinitas vezes, sem que estes tenham de ser repetidos. Ou seja, em PHP, funções facilitam a realização de tarefas e ainda diminuem a possibilidade de ocorrência de erros.

O que são funções em PHP?

Funções em PHP são blocos de código nomeados que executam uma instrução específica ou uma série de instruções. Essenciais para uma programação mais organizada, elas dividem códigos escritos em PHP em unidades estruturadas e reutilizáveis. A linguagem PHP suporta tanto funções internas, utilizadas na execução de tarefas comuns por strings, arrays e loops PHP, quanto funções criadas por usuários. Estas possibilitam que projetos e aplicações sejam personalizados.

Diferenças entre funções internas e criadas por usuários

Entende-se por funções internas (built-in functions), funções já incorporadas e comuns à linguagem de programação PHP. A maioria delas integra a biblioteca da linguagem e é disponibilizada a qualquer usuário, sem a necessidade de qualquer complemento. Há aquelas, contudo, que requerem extensões especiais. Funções em PHP são utilizadas para que tarefas comuns sejam programadas e realziadas com mais eficiência. Um exemplo é a função strlen(), que calcula o tamanho de uma string. Esta e outras funcionam otimizando códigos e aumentando o desempenho deles.

Já funções definidas pelo usuário nada mais são que funções criadas por um usuário específico, para o atendimento de uma demanda particular, ou para o solucionamento de um problema de um projeto em desenvolvimento ou execução. Esse tipo de função requer uma definição mais detalhada para que funcione corretamente.

Funções PHP definidas pelo usuário podem abranger algoritmos complexos e manipular dados. É possível, por exemplo, criar funções que fazem uso do PHP para recuperar dados em bancos de dados MySQL/MariaDB e que formatam esses dados para que eles sejam corretamente exibidos por páginas da internet.

Sintaxe de funções em PHP

Funções em PHP definidas pelo usuário devem seguir determinados padrões para que possam ser executadas por um vódigo. Observe a estrutura básica que uma função em PHP deve respeitar:

function functionName(parameter1, parameter2, ...) {
    // php function example code block
    return result; // optional
}

Destacamos e explicamos cada parte que compõem uma função PHP:

• function: Essa palavra-chave sinaliza o início da definição da função.
• functionName: Indica o nome da função, que deve ser único e descrever a finalidade dela.
• parameter1, parameter2, …: Parâmetros nada mais são que valores a serem transmitidos a uma função PHP no momento de sua execução. Eles são opcionais e podem ser usados em qualquer quantidade.
• code block: Bloco de código que executa a tarefa ou desempenha a operação programada.
• return result(opcional): Somente se a função tiver de retornar um resultado você precisará adicionar ao código a declaração “return” (PHP function return).

Funções internas não precisam ser definidas ao serem utilizadas. Você pode executá-las de forma direta, sendo suficiente o respectivo identificador.

Function PHP: Exemplos de uso

Acompanhe, abaixo, como funções em PHP podem ser aplicadas a códigos, em casos práticos:

Atribuir valores padrão a parâmetros

Você pode definir valores padrão para parâmetros de uma função em PHP (PHP funtion parameter). Para fazer isso, especifique o valor padrão desejado na definição da função. Caso nenhum valor seja informado para um parâmetro no momento da definição da função, a ela será aplicado o valor padrão.

function greet($name = "Tim") { 
    echo "Hello, $name"; 
} 
 
greet(); // Output: "Hello, Tim" 
greet("Max"); // Output: "Hello, Max" 

Transferir argumentos por referência

Valores podem ser transferidos a uma função “por valor” ou “por referência”. Transferências “por valor” utilizam uma cópia do valor para a realização das alterações. Isso quer dizer que as alterações realizadas não afetam o valor original fora da função. Por outro lado, transferências “por referência” transmitem a variável real para a função. Nesse caso, as modificações realizadas afetam o valor original. Faça esse tipo de transmissão adicionando o caractere especial & à definição da função, como mostra o exemplo de código abaixo:

function incrementByOne(&$num) {
    $num++;
}
$val = 5;
incrementByOne($val);
echo $val; // Output: "6"

Nesse código de exemplo, definimos a função incrementByOne utilizando o parâmetro $num, transmitido por referência. O trecho subsequente ao incremento trata-se de um operador PHP. Especificamente, ele adiciona 1 a números ou strings. Assim, ao ser executada, a função PHP acima aumentará o valor $val de 5 para 6. A mudança também será executada externamente, uma vez que essa se trata de uma transmissão de parâmetro por referência.