Resumo : neste tutorial, você aprenderá sobre funções PHP e como definir funções definidas pelo usuário.
O que é uma função
Uma função é um bloco de código nomeado que executa uma tarefa específica.
Até agora, você aprendeu como usar funções integradas no PHP, como var_dump()
aquelas que despejam informações sobre uma variável.
Neste tutorial, você aprenderá como definir suas funções. Essas funções são chamadas de funções definidas pelo usuário.
Por que você precisa de funções em primeiro lugar?
Às vezes, você precisa executar a mesma tarefa várias vezes em um script. Por exemplo, suponha que você queira mostrar uma mensagem de boas-vindas a um usuário como esta:
<?php
echo 'Welcome!';
Linguagem de código: HTML, XML ( xml )
Se quiser mostrar a mesma mensagem em outros lugares, você deve copiar a instrução acima e colá-la em vários lugares.
Mas quando você quiser mudar a mensagem de Welcome!
para Welcome Back
! você precisa alterá-lo em vários lugares. Isso tornará o código muito difícil de manter.
É aqui que as funções entram em jogo. Uma função permite atribuir um nome a um bloco de código e reutilizá-lo em vários locais sem duplicar o código.
Para definir e chamar uma função definida pelo usuário, use as seguintes etapas:
Primeiro, defina uma função chamada welcome()
assim:
<?php
function welcome()
{
echo 'Welcome!';
}
Linguagem de código: HTML, XML ( xml )
Em seguida, chame a welcome()
função em qualquer lugar onde deseja mostrar a mensagem de boas-vindas:
<?php
welcome();
Linguagem de código: HTML, XML ( xml )
Posteriormente, se desejar uma mensagem diferente, você poderá alterá-la centralmente na welcome()
função, em vez de em vários locais.
Ao usar uma função, você pode reutilizar um bloco de código e facilitar a manutenção do seu script.
Definir uma função
Para definir uma função, você usa a seguinte sintaxe:
<?php
function function_name() {
statement;
}
Linguagem de código: HTML, XML ( xml )
Nesta sintaxe:
- Primeiro, especifique o nome da função seguido da
function
palavra-chave. O nome da função precisa começar com uma letra ou sublinhado seguido por zero ou mais letras, sublinhados e dígitos. - Segundo, defina uma ou mais instruções dentro do corpo da função. O corpo da função começa com
{
e termina com}
.
Como no exemplo acima, você pode definir uma função chamada welcome()
da seguinte forma:
<?php
function welcome()
{
echo 'Welcome';
}
Linguagem de código: HTML, XML ( xml )
Neste exemplo, o nome da função é welcome
. A welcome()
função exibe a mensagem de boas-vindas.
A welcome()
função não tem entrada. Mostra a mensagem de boas-vindas.
Na prática, as funções geralmente aceitam entradas. As entradas tornam as funções reutilizáveis e mais úteis. E as entradas de uma função são chamadas de parâmetros .
Uma função pode ter zero ou mais parâmetros. Para adicionar um ou mais parâmetros a uma função, você pode usar a seguinte sintaxe:
<?php
function function_name(parameter1, parameter2, ...) {
}
Linguagem de código: HTML, XML ( xml )
Dentro do corpo da função, você pode usar parâmetros como variáveis . Na verdade, os parâmetros são as variáveis locais .
Por exemplo, se quiser dar as boas-vindas aos usuários pelos seus nomes de usuário, você pode adicionar um $username
parâmetro à welcome
função da seguinte maneira:
<?php
function welcome_user($username)
{
echo 'Welcome ' . $username;
}
Linguagem de código: HTML, XML ( xml )
A welcome_user()
função possui um parâmetro $username
. Ele exibe uma mensagem de boas-vindas ao usuário concatenando a Welcome
mensagem com $username
.
Chame uma função
Quando uma função não possui nenhum parâmetro, você pode chamá-la usando seu nome seguido de parênteses como este:
<?php
function_name();
Linguagem de código: HTML, XML ( xml )
Por exemplo:
<?php
function welcome()
{
echo 'Welcome!';
}
welcome();
Linguagem de código: HTML, XML ( xml )
A welcome()
função mostra a seguinte mensagem:
Welcome!
E quando você chama a função com parâmetros, você precisa passar argumentos para ela:
O exemplo a seguir chama a welcome_user()
função:
<?php
function welcome_user($username)
{
echo 'Welcome ' . $username;
}
welcome_user('Admin');
Linguagem de código: HTML, XML ( xml )
Neste exemplo, passamos o 'Admin'
argumento para a welcome_user()
função. A função exibe a seguinte mensagem:
Welcome Admin!
Dentro da welcome_user()
função, o valor de $username
é 'Admin
‘.
Se você passar outro argumento para a função, a mensagem mudará. Por exemplo:
<?php
welcome_user('Guest');
Linguagem de código: HTML, XML ( xml )
Saída:
Welcome Guest!
Parâmetros vs. argumentos
Os termos parâmetros e argumentos são frequentemente usados de forma intercambiável. No entanto, eles são um pouco diferentes.
Ao definir uma função que aceita entradas, você especifica os parâmetros. Neste exemplo, $username
é um parâmetro de função:
<?php
function welcome_user($username)
{
echo 'Welcome ' . $username . '!';
}
Linguagem de código: HTML, XML ( xml )
Um argumento é um dado que você passa para a função ao chamá-la. Na chamada de função a seguir, a string literal 'Admin'
é um argumento:
<?php
welcome_user('Admin');
Linguagem de código: HTML, XML ( xml )
Retornar um valor
Uma função pode retornar um valor. Para retornar um valor de uma função, você usa a return
instrução:
return value;
Linguagem de código: JavaScript ( javascript )
A return
instrução encerra imediatamente a execução da função atual e retorna o valor.
O valor pode ser um valor literal, como um número e uma string. Além disso, pode ser uma variável ou uma expressão.
A função a seguir retorna uma mensagem de boas-vindas em vez de exibi-la:
<?php
function welcome_user($username)
{
return 'Welcome '. $username . '!';
}
Linguagem de código: HTML, XML ( xml )
Como a welcome_user()
função retorna uma string, você pode atribuir seu valor de retorno a uma variável como esta:
$welcome_message = welcome_user('Admin');
Linguagem de código: PHP ( php )
Ou você pode exibi-lo:
<?php echo welcome_user(); ?>
Linguagem de código: HTML, XML ( xml )
Código HTML dentro da função
Normalmente, uma função contém apenas código PHP. Porém, é possível definir uma função que contenha código HTML. A welcome()
função a seguir exibe a mensagem de boas-vindas envolvida em uma span
tag:
<?php function welcome_user($username) { ?>
<span>Welcome <?= $username ?></span>
<?php } ?>
Linguagem de código: HTML, XML ( xml )
Resumo
- Uma função é um bloco de código nomeado que executa uma tarefa específica.
- Use funções para criar código reutilizável.
- Use a
return
instrução para retornar um valor de uma função.