Function PHP: Como usar funções em PHP para reu­ti­li­zar 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 re­a­li­za­ção de tarefas e ainda diminuem a pos­si­bi­li­dade de ocor­rên­cia 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 es­pe­cí­fica ou uma série de ins­tru­ções. Es­sen­ci­ais para uma pro­gra­ma­ção mais or­ga­ni­zada, elas dividem códigos escritos em PHP em unidades es­tru­tu­ra­das e reu­ti­li­zá­veis. A linguagem PHP suporta tanto funções internas, uti­li­za­das na execução de tarefas comuns por strings, arrays e loops PHP, quanto funções criadas por usuários. Estas pos­si­bi­li­tam que projetos e apli­ca­ções sejam per­so­na­li­za­dos.

Di­fe­ren­ças entre funções internas e criadas por usuários

Entende-se por funções internas (built-in functions), funções já in­cor­po­ra­das e comuns à linguagem de pro­gra­ma­ção PHP. A maioria delas integra a bi­bli­o­teca da linguagem e é dis­po­ni­bi­li­zada a qualquer usuário, sem a ne­ces­si­dade de qualquer com­ple­mento. Há aquelas, contudo, que requerem extensões especiais. Funções em PHP são uti­li­za­das para que tarefas comuns sejam pro­gra­ma­das e re­al­zi­a­das com mais efi­ci­ên­cia. Um exemplo é a função strlen(), que calcula o tamanho de uma string. Esta e outras funcionam oti­mi­zando códigos e au­men­tando o de­sem­pe­nho deles.

Já funções definidas pelo usuário nada mais são que funções criadas por um usuário es­pe­cí­fico, para o aten­di­mento de uma demanda par­ti­cu­lar, ou para o so­lu­ci­o­na­mento de um problema de um projeto em de­sen­vol­vi­mento ou execução. Esse tipo de função requer uma definição mais detalhada para que funcione cor­re­ta­mente.

Funções PHP definidas pelo usuário podem abranger al­go­rit­mos 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 cor­re­ta­mente exibidos por páginas da internet.

Sintaxe de funções em PHP

Funções em PHP definidas pelo usuário devem seguir de­ter­mi­na­dos padrões para que possam ser exe­cu­ta­das 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
}

Des­ta­ca­mos e ex­pli­ca­mos cada parte que compõem uma função PHP:

• function: Essa palavra-chave sinaliza o início da definição da função.
• func­ti­on­Name: Indica o nome da função, que deve ser único e descrever a fi­na­li­dade dela.
• parameter1, parameter2, …: Pa­râ­me­tros nada mais são que valores a serem trans­mi­ti­dos a uma função PHP no momento de sua execução. Eles são opcionais e podem ser usados em qualquer quan­ti­dade.
• code block: Bloco de código que executa a tarefa ou de­sem­pe­nha a operação pro­gra­mada.
• return result(opcional): Somente se a função tiver de retornar um resultado você precisará adicionar ao código a de­cla­ra­ção “return” (PHP function return).

Funções internas não precisam ser definidas ao serem uti­li­za­das. Você pode executá-las de forma direta, sendo su­fi­ci­ente o res­pec­tivo iden­ti­fi­ca­dor.

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 pa­râ­me­tros

Você pode definir valores padrão para pa­râ­me­tros de uma função em PHP (PHP funtion parameter). Para fazer isso, es­pe­ci­fi­que 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"

Trans­fe­rir ar­gu­men­tos por re­fe­rên­cia

Valores podem ser trans­fe­ri­dos a uma função “por valor” ou “por re­fe­rên­cia”. Trans­fe­rên­cias “por valor” utilizam uma cópia do valor para a re­a­li­za­ção das al­te­ra­ções. Isso quer dizer que as al­te­ra­ções re­a­li­za­das não afetam o valor original fora da função. Por outro lado, trans­fe­rên­cias “por re­fe­rên­cia” trans­mi­tem a variável real para a função. Nesse caso, as mo­di­fi­ca­ções re­a­li­za­das afetam o valor original. Faça esse tipo de trans­mis­são adi­ci­o­nando 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 in­cre­mentByOne uti­li­zando o parâmetro $num, trans­mi­tido por re­fe­rên­cia. O trecho sub­se­quente ao in­cre­mento trata-se de um operador PHP. Es­pe­ci­fi­ca­mente, 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 ex­ter­na­mente, uma vez que essa se trata de uma trans­mis­são de parâmetro por re­fe­rên­cia.