{"id":3967,"date":"2022-07-15T12:37:00","date_gmt":"2022-07-15T15:37:00","guid":{"rendered":"https:\/\/categoriaoutros.com.br\/?p=3967"},"modified":"2023-08-21T14:30:29","modified_gmt":"2023-08-21T17:30:29","slug":"php-017-funcoes","status":"publish","type":"post","link":"https:\/\/categoriaoutros.com.br\/?p=3967","title":{"rendered":"PHP – Aula 017: Fun\u00e7\u00f5es"},"content":{"rendered":"\n

Fun\u00e7\u00e3o<\/strong>(function) \u00e9 um bloco de instru\u00e7\u00f5es(c\u00f3digos) que pode ser usado repetidamente em um programa. Usamos fun\u00e7\u00f5es quando precisamos executar a mesma tarefa v\u00e1rias vezes em um script sem duplicar o c\u00f3digo. Mais tarde, se voc\u00ea quiser ter uma mensagem diferente, poder\u00e1 alterar a fun\u00e7\u00e3o em um \u00fanico luga em vez de em v\u00e1rios lugares.<\/p>\n\n\n\n

O verdadeiro poder do PHP vem de suas fun\u00e7\u00f5es. O PHP possui mais de 1000 fun\u00e7\u00f5es integradas e, al\u00e9m disso, voc\u00ea pode criar suas pr\u00f3prias fun\u00e7\u00f5es personalizadas. Podemos chamar essas fun\u00e7\u00f5es para realizarem uma tarefa espec\u00edfica.<\/p>\n\n\n\n

J\u00e1 vimos algumas, como date(), var_dump(), is_string()…. Essas fun\u00e7\u00f5es pr\u00f3prias do php. Mas podemos criar as nossas. <\/p>\n\n\n\n

Em resumo: Uma fun\u00e7\u00e3o \u00e9 um peda\u00e7o de c\u00f3digo que faz algum processamento e retorna um valor.<\/em><\/p>\n\n\n\n

Sintaxe de uma fun\u00e7\u00e3o em php:<\/h2>\n\n\n\n

Um nome de fun\u00e7\u00e3o deve come\u00e7ar com uma letra ou um sublinhado. Os nomes das fun\u00e7\u00f5es N\u00c3O diferenciam mai\u00fasculas de min\u00fasculas.<\/p>\n\n\n\n

function nome_funcao() {\n  c\u00f3digo a ser executado;\n}<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Exemplos de Fun\u00e7\u00f5es em PHP<\/h2>\n\n\n\n
<\/p>\n\n\n\n
<?php\n        function escrevaMensagem() {\n           echo \"Oi, Sou uma fun\u00e7\u00e3o<br>\";\n           echo \"posso ser chamada quantas vezes quiser\";\n           echo \"---\";\n        }\n\n        escrevaMensagem();\n        echo \"<br>\";\n        escrevaMensagem();\n        echo \"<br>\" ; \n        escrevaMensagem();          \n        \n   ?>\n<\/code><\/pre>\n\n\n\n
Acima, criei a fun\u00e7\u00e3o e a chamei 3 vezes. Esse \u00e9 o resultado:<\/p>\n\n\n\n
Oi, Sou uma fun\u00e7\u00e3o
posso ser chamada quantas vezes quiser
—
Oi, Sou uma fun\u00e7\u00e3o
posso ser chamada quantas vezes quiser
—
Oi, Sou uma fun\u00e7\u00e3o
posso ser chamada quantas vezes quiser
—<\/mark><\/p>\n\n\n\n
<\/p>\n\n\n\n
PAR\u00c2METROS E ARGUMENTOS NA FUN\u00c7\u00c3O<\/strong><\/h5>\n\n\n\n
Fun\u00e7\u00f5es<\/strong> tamb\u00e9m aceitam par\u00e2metros<\/strong>. Par\u00e2metros s\u00e3o valores, geralmente dentro de vari\u00e1veis, que passamos dentro dos par\u00eanteses (…)<\/p>\n\n\n\n
Abaixo, $nome<\/mark> \u00e9 um par\u00e2metro<\/strong> e “Maria”<\/mark>, “Joao”<\/mark>, “Silva”<\/mark> s\u00e3o argumentos<\/strong>.<\/p>\n\n\n\n
   <?php\n        function quemSou($nome<\/mark>) {\n           echo \"Oi, Sou $nome\";\n         }\n\n        quemSou(\"Maria\"<\/mark>);\n        echo \"<br>\";\n        quemSou(\"Joao\"<\/mark>);\n        echo \"<br>\" ; \n        quemSou(\"Silva\"<\/mark>);               \n\n   ?>\n<\/code><\/pre>\n\n\n\n
Acima, passamos nomes como argumentos para as fun\u00e7\u00f5es. O resultado ser\u00e1: <\/p>\n\n\n\n
Oi, Sou Maria<\/mark>
Oi, Sou Joao
Oi, Sou Silva<\/mark><\/p>\n\n\n\n
Podemos ter mais de um par\u00e2metro<\/p>\n\n\n\n
   <?php\n        function quemSou($nome, <\/mark>$idade<\/mark>, <\/mark>$peso<\/mark>, <\/mark>$sexo<\/mark>) {\n\n        echo \"Oi, Sou $nome<\/mark>, tenho $idade<\/mark> anos, peso $peso<\/mark> <\/mark>quilos e do sexo $sexo<\/mark> \"\n         }\n\n        quemSou(\"Maria\", 34, 67, \"feminino\");\n        echo \"<br>\";\n        quemSou(\"Joao\", 55, 80, \"masculino\");\n  ?> <\/code><\/pre>\n\n\n\n
Resultado:<\/p>\n\n\n\n
Oi, Sou Maria, tenho 34 anos, peso 67 quilos e do sexo feminino
Oi, Sou Joao, tenho 55 anos, peso 80 quilos e do sexo masculino<\/mark><\/p>\n\n\n\n
<\/p>\n\n\n\n
Vejamos outro exemplo onde somamos valores dentro de uma fun\u00e7\u00e3o:<\/p>\n\n\n\n
    <?php\n        function soma($valor1, $valor2) {\n        $soma = $valor1 + $valor2;      \n        echo \"$valor1 + $valor2 = $soma <br> \";\n         }\n          soma(4,6);\n          soma(34, 88);\n          soma(4, 9);\n          soma(3,8); \n  ?>      <\/code><\/pre>\n\n\n\n
Resultado:<\/p>\n\n\n\n
4 + 6 = 10\n34 + 88 = 122\n4 + 9 = 13\n3 + 8 = 11<\/em><\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
PASSANDO ARGUMENTOS POR REFER\u00caNCIA<\/strong><\/p>\n\n\n\n
Ao colocarmos um & passamos argumentos por refer\u00eancia; isso significa que a vari\u00e1vel \u00e9 manipulada pela fun\u00e7\u00e3o.<\/p>\n\n\n\n
Quaisquer altera\u00e7\u00f5es feitas em um argumento nesses casos alterar\u00e3o o valor da vari\u00e1vel original.<\/p>\n\n\n\n
Podemos passar um argumento por refer\u00eancia adicionando um “E” comercial(&) ao nome da vari\u00e1vel na chamada(arguimento) da fun\u00e7\u00e3o ou na defini\u00e7\u00e3o(par\u00e2metro) da fun\u00e7\u00e3o.<\/p>\n\n\n\n
    <?php\n        function addDez(&<\/mark><\/strong>$num) {\n           $num += 10;   \n         }\n\n        $num_inicial = 10;\n\n        echo  \"valor inicial \u00e9 $num_inicial <br>\";\n        addDez($num_inicial);\n        echo  \"valor inicial \u00e9 $num_inicial <br>\";\n        addDez($num_inicial);\n        echo  \"valor inicial \u00e9 $num_inicial <br>\";\n        addDez($num_inicial);\n        echo  \"valor inicial \u00e9 $num_inicial <br>\";\n        addDez($num_inicial);\n        echo  \"valor inicial \u00e9 $num_inicial <br>\";\n  ?>     <\/code><\/pre>\n\n\n\n
O resultado ser\u00e1:<\/p>\n\n\n\n
valor inicial \u00e9 10\nvalor inicial \u00e9 20\nvalor inicial \u00e9 30\nvalor inicial \u00e9 40\nvalor inicial \u00e9 50<\/em><\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Retornando um Valor <\/h2>\n\n\n\n
Uma fun\u00e7\u00e3o pode retornar um valor. Para retornar um valor de uma fun\u00e7\u00e3o, voc\u00ea usa a instru\u00e7\u00e3o return<\/em><\/mark>. Exemplo<\/p>\n\n\n\n
        function quemSou($nome<\/mark>) {\n           .....\n           return algum_valor<\/mark>\n         }         <\/code><\/pre>\n\n\n\n
return<\/em><\/mark> termina imediatamente a execu\u00e7\u00e3o da fun\u00e7\u00e3o atual e retorna o valor.<\/p>\n\n\n\n
algum_valor<\/mark> pode ser qualquer valor \ud83d\ude42 como uma string ou integer, uma vari\u00e1vel ou express\u00e3o.<\/p>\n\n\n\n
Vamos ver na pr\u00e1tica:<\/p>\n\n\n\n
 <?php\n        function quemSou($nome, $idade, $peso, $sexo) {\n\n        return<\/em><\/mark> \"Oi, Sou $nome, tenho $idade anos, peso $peso quilos e do sexo $sexo\"\n         }\n\n        $quemsou = quemSou(\"Maria\", 34, 67, \"feminino\");\n        echo $quemsou;\n\n  ?>    \n   <\/code><\/pre>\n\n\n\n
No caso acima, a fun\u00e7\u00e3o retorna(return) uma string que \u00e9 passada para $quemsou. Pode comprovar isso usando <\/p>\n\n\n\n
echo var_dump($quemsou);  <\/mark><\/em><\/p>\n\n\n\n
 ou <\/p>\n\n\n\n
echo var_dump(quemSou(“Maria”, 34, 67, “feminino”));<\/mark><\/em><\/p>\n\n\n\n
<\/p>\n\n\n\n
Definindo valor padr\u00e3o para par\u00e2metros<\/h2>\n\n\n\n
   <?php\n        function multiplica($num<\/mark>) {\n         return print \"Valor retornado \u00e9 \" .   $num *= 2;\n         }\n\n        multiplica();\n   ?> <\/code><\/pre>\n\n\n\n
Se a fun\u00e7\u00e3o acima espera um argumento mas como nenhum foi passado em multiplica(); <\/mark>ent\u00e3o teremos esse erro:<\/p>\n\n\n\n
Fatal error:<\/strong> Uncaught ArgumentCountError: Too few arguments to function addDez(), 0 passed in \/var\/www\/html\/meusite\/index.php on line 10 and exactly 1 expected in......<\/mark><\/code><\/pre>\n\n\n\n
Podemos definir um valor padr\u00e3o para o caso onde nenhum argumento seja passado, desse modo o valor padr\u00e3o ser\u00e1 retornado para que n\u00e3o gere erro. <\/p>\n\n\n\n
Abaixo declaramos que $num =  NULL<\/mark>. Com isso mesmo que n\u00e3o passemos um argumento para a fun\u00e7\u00e3o n\u00e3o gerar\u00e1 erro.<\/p>\n\n\n\n
   <?php\n        function multiplica($num =  NULL<\/mark>) {\n         return print \"Valor retornado \u00e9 \" .   $num *= 2;\n         }\n\n        multiplica();\n   ?> <\/code><\/pre>\n\n\n\n
Vejamos outro exemplo<\/p>\n\n\n\n
    <?php       \n        function dadosPessoais($nome = ''<\/mark>, $pais = 'Brasil'<\/mark>){\n                echo \"Sou $nome e nasci em $pais<br>\";\n        }\n\n        dadosPessoais('Maria');\n        dadosPessoais('Joao','Italia'); \n    ?><\/code><\/pre>\n\n\n\n
O resultado ser\u00e1:<\/p>\n\n\n\n
Sou Maria e nasci em Brasil\nSou Joao e nasci em Italia<\/em><\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
<\/p>\n\n\n\n
HTML dentro da fun\u00e7\u00e3o<\/h2>\n\n\n\n
Normalmente, uma fun\u00e7\u00e3o cont\u00e9m apenas c\u00f3digo PHP. No entanto, \u00e9 poss\u00edvel definir uma fun\u00e7\u00e3o que cont\u00e9m c\u00f3digo HTML.<\/p>\n\n\n\n
       <?php     function funcaoHTML($nome = NULL) {  ?>\n                <h1>HTML dentro de uma Fun\u00e7\u00e3o<\/h1>    <\/mark>    \n\n      <?php }  funcaoHTML(\"Maria\");   ?> <\/code><\/pre>\n\n\n\n
Isso retornar\u00e1:<\/p>\n\n\n\n
HTML dentro de uma Fun\u00e7\u00e3o<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Argumentos Nomeados(named arguments)<\/h2>\n\n\n\n
Esta fun\u00e7\u00e3o est\u00e1 dispon\u00edvel somente a partir da vers\u00e3o 8.0 do PHP.<\/p>\n\n\n\n
Com Argumentos Nomeados<\/strong>, com os nomes dos par\u00e2metros, as posi\u00e7\u00f5es dos argumentos n\u00e3o precisam seguir a mesma ordem dos par\u00e2metros.<\/p>\n\n\n\n
<?php       \n        function dadosPessoais($nome, $sexo, $pais){\n                echo \"Sou $nome,  e nasci em $pais<br>\";\n        }\n\n        dadosPessoais(sexo:'masculino', nome:'Maria', pais:'Brasil'<\/mark>);\n                     \n?><\/code><\/pre>\n\n\n\n
Podemos misturar “Argumentos Nomeados<\/strong>” com os “Argumentos com Posi\u00e7\u00f5es fixadas<\/strong>“, por\u00e9m os argumentos nomeados t\u00eam que estar depois.<\/p>\n\n\n\n
A chamada abaixo daria erro:<\/p>\n\n\n\n
dadosPessoais(‘masculino’<\/mark>, nome:’Maria’, pais:’Brasil’<\/mark>);<\/p>\n\n\n\n
pois ‘masculino’<\/mark> \u00e9 posicional mas est\u00e1 antes dos argumentos nomeados.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Conclus\u00e3o<\/h2>\n\n\n\n
Uma fun\u00e7\u00e3o \u00e9 um bloco de c\u00f3digo que tem um  nome. Ao chamarmos a fun\u00e7\u00e3o por seu nome ela fun\u00e7\u00e3o \u00e9 invocada e executada uma tarefa espec\u00edfica.<\/p>\n\n\n\n
Use fun\u00e7\u00f5es para criar c\u00f3digo reutiliz\u00e1vel.<\/p>\n\n\n\n
Use a instru\u00e7\u00e3o return<\/em><\/mark> para retornar um valor de uma fun\u00e7\u00e3o.<\/p>\n\n\n\n
Desde o PHP 8.0, a lista de par\u00e2metros pode ter a v\u00edrgula (,) <\/p>\n\n\n\n
Por padr\u00e3o, os argumentos s\u00e3o passados \u200b\u200b”por valor” no PHP, mas ao colocarmos um “e comercial (&)” tanto no argumento quanto no par\u00e2metro eles ser\u00e3o passados por refer\u00eancia<\/strong>.<\/p>\n\n\n\n
Podemos quebrar a lista de argumentos verticalmente para tornar o c\u00f3digo mais leg\u00edvel assim:<\/p>\n\n\n\n
<?php     \n    .......      \n    multiplica(\n        'maria',\n        '12',\n        'feminino',\n        'parda'\n        );\n?><\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Artigos Relacionados<\/h2>\n\n\n\n
Temos outros artigos que falam sobre fun\u00e7\u00f5es:<\/p>\n\n\n\n