PHP - Funções

Curso da Linguagem de Programação PHP da disciplina Desenvolvimento de Sistemas Web da Universidade Estadual do Sudoeste da Bahia - UESB.

1. Curso de PHP – Funções
Fábio M. Pereira
UNIVERSIDADE ESTADUAL DO SUDOESTE
DA BAHIA – UESB
UNIDADE ORGANIZACIONAL DE
INFORMÁTICA - UINFOR

2. Roteiro
•Introdução
•Chamando uma Função
•Definindo uma Função
•Escopo de Variáveis
–Variáveis Globais
–Variáveis Estáticas
•Parâmetros de Função
–Passagem de Parâmetros por Valor
–Passagem de Parâmetros por Referência
–Parâmetros Default
–Parâmetros Variáveis
–Parâmetros Faltando
–Definição de Tipo
•Retornando Valores
•Variáveis com Nomes de Funções
•Funções Anônimas

3. FUNÇÕES
Introdução

4. Funções
•Uma função é um bloco nomeado de código que realiza
uma tarefa específica
•Possui a possibilidade de receber um conjunto de valores
(parâmetros) e de retornar um único valor
•Aumenta a legibilidade do código por isolar o código que
realiza tarefas específicas

5. FUNÇÕES
Chamando uma Função

6. Chamando uma Função
•Funções em um programa PHP podem ser embutidas ou
definidas pelo usuário
•Independentemente da origem, todas as funções são
avaliadas da mesma maneira:
$someValue = function_name( [ parameter, ... ] );
•O número de parâmetros que uma função requer pode
variar de uma função para outra (e também na mesma
função)
•Exemplos:
// strlen() é uma função interna que retorna o
// tambanho de umastring
$length = strlen("PHP"); // $length é agora 3

7. Chamando uma Função
•Exemplos (cont.):
// sin() e asin() são funções matemáticas
// seno e arco-seno
// $result é o seno do arco-seno de 1:
$result = sin(asin(1));
// unlink() apaga um arquivo
// retorna falso se falhar
$result = unlink("functions.txt");
•Reescrevendo a última função:
$result = unlink("functions.txt")
or die("Falha na Operação!");

8. FUNÇÕES
Definindo uma Função

9. Definindo uma Função
•Para criar uma função, devemos utilizar a seguinte
sintaxe:
function [&] nome_da_função([parametros[, ...]])
{
lista de instruções
}
•A lista de instruções pode incluir HTML
•Podemos declarar uma função PHP que não contenha
nenhum código PHP
•Exemplo:
<?php function column()
{ ?>
<td></td>
<?php }

10. Definindo uma Função
•O nome de uma função pode ser qualquer string que
inicie por uma letra ou sublinhado seguido por nenhuma
ou mais letras, sublinhados e dígitos
•Nomes de funções não são sensíveis à caixa, assim
sin(1), SIN(1), SiN(1), etc. se referem à mesma
função
•Por convenção, funções internas em PHP são chamadas
com todas as letras em minúsculo
•Tipicamente, funções retornam algum valor
•Para retornar o valor de uma função, devemos utilizar a
instrução return
•Podemos incluir qualquer quantidade de instruções
return em uma função

11. Exemplos
•Concatenação de strings:
function strcat($left, $right)
{
$combinedString = $left . $right;
return $combinedString;
}
•Simplificando:
function strcat($left, $right)
{
return $left . $right;
}
•Em uma página PHP:
<?php
function strcat($left, $right)
{
return $left . $right;
}
$first = "This is a ";
$second = " complete sentence!";
echo strcat($first, $second);

12. Aninhamento
•Podemos aninhar declaração de funções, mas com efeito
limitado
–Não limita a visibilidade da função interna que pode ser chamada de
qualquer lugar do programa
–Não pega automaticamente os argumentos da função externa
–A função interna só poderá ser chamada dentro do programa após a
chamada da função externa
function outer ($a)
{
function inner ($b)
{
echo "there $b";
}
echo "$a, hello ";
}
// saída: "well, hello there reader"
outer("well");
inner("reader");

13. FUNÇÕES
Escopo de Variáveis

14. Escopo de Variáveis
•Se não usarmos funções, qualquer variável criada poderá ser
usada em qualquer lugar em uma página
•Funções mantém seus próprios conjuntos de variáveis que
são distintos daquelas da página e de outras funções
–As variáveis definidas em uma função, incluindo os seus parâmetros,
não são acessíveis fora da função
–Por padrão, variáveis definidas fora de uma função não são acessíveis
dentro da função
$a = 3;
function foo()
{
$a += 2;
}
foo();
echo $a; // Qual o valor de $a?

15. Variáveis Globais
•Se quisermos uma variável de escopo global, que possa
ser acessada de dentro de uma função, podemos utilizar
a palavra-chave global:
global var1, var2, ...
–Parâmetros de função nunca poderão ser variáveis globais
•Modificando o exemplo anterior:
$a = 3;
function foo()
{
global $a;
$a += 2;
}
foo();
echo $a; // Qual o valor de $a ?

16. Variáveis Globais
•Usar global é equivalente a criar uma referência à
variável $GLOBALS
•Então, as instruções a seguir têm o mesmo efeito:
global $var;

$var = $GLOBALS['var'];

17. Variáveis Estáticas
•Assim como C, PHP dá suporte à declaração de variáveis de
função estáticas
–É inicializada apenas na primeira vez em que a função é chamada
–Retém o seu valor em todas as chamadas da função
•Utilizamos a palavra-chave static no primeiro uso para
declarar uma variável de função estática:
static var [= value][, ... ];
•Exemplo:
<?php
function counter()
{
static $count = 0;
return $count++;
}
for ($i = 1; $i <= 5; $i++) {
print counter();
}

18. FUNÇÕES
Parâmetros de Função

19. Parâmetros de Função
•Funções podem esperar, por declaração em sua
definição, um número qualquer de argumentos
•Existem duas maneiras diferentes de passar parâmetros
para um função:
–A primeira e mais comum, por valor
–A outra, por referência
•Passagem de parâmetros por valor
–O argumento é qualquer expressão válida
–A expressão é avaliada e o valor resultante é atribuído à variável
apropriada na função
–Em todos os exemplos vistos até agora, a passagem de
argumentos foi por valor

20. Passagem de Parâmetros por
Referência
•Passagem por referência permite sobrepor as regras normais
de escopo e dar à função acesso direto a uma variável
–Para ser passado por referência, o argumento deve ser uma variável
•Indicamos um argumento em particular de uma função que
será passado por referência precedendo o nome da variável
na lista de parâmetros com o sinal (&)
<?php
function doubler(&$value)
{
$value = $value * 2;
}
$a = 3;
doubler($a);
echo $a;

21. Passagem de Parâmetros por
Referência
•Apenas variáveis – não constantes – podem ser fornecidas a
parâmetros declarados por referência
•Assim, no exemplo anterior, a instrução a seguir geraria um
erro:
<?= doubler(7); ?>
•Entretanto, podemos definir um valor padrão para
parâmetros passados por referência
•Mesmo em casos em que não modifiquemos o valor dados,
podemos querer que os mesmos sejam passados por
referência
–Quando passamos por valor, PHP faz uma cópia do valor armazenado
–Particularmente em strings longas e objetos, esta pode ser uma
operação cara
–Passando por referência removemos a necessidade de cópia do valor

22. Parâmetros Default
•Para especificar um parâmetro default (padrão),
atribuímos o valor do parâmetro na declaração da função
–O valor atribuído não pode ser uma expressão complexa,
apenas um valor escalar
•Uma função pode ter qualquer número de parâmetros
com valores default
•Entretanto, eles devem ser listados após todos os
parâmetros que não tenham valores default
•Exemplo:
function getPreferences($whichPreference = 'all')
{
// instruções
}

23. Parâmetros Variáveis
•Uma função pode precisar de um número variável de
parâmetros
•Para declarar uma função com um número variável de
parâmetros, simplesmente retire o bloco de parâmetros
inteiro
function getPreferences()
{
// algum código
}
•PHP fornece três funções para recuperar os parâmetros
passados:
–func_get_args() retorna um array com todos os parâmetros
passados para a função
–func_num_args() retorna a quantidade de parâmetros fornecidos
–func_get_arg() retorna um parâmetro específico

24. Parâmetros Variáveis
•Uma função pode precisar de um número variável de
parâmetros
•Para declarar uma função com um número variável de
parâmetros, simplesmente retire o bloco de parâmetros
inteiro
function getPreferences()
{
// algum código
}
•PHP fornece três funções para recuperar os parâmetros
passados:
–func_get_args() retorna um array com todos os parâmetros
passados para a função
–func_num_args() retorna a quantidade de parâmetros fornecidos
–func_get_arg() retorna um parâmetro específico
$array = func_get_args();
$count = func_num_args();
$value = func_get_arg(argument_number);

25. Exemplo
<?php
function countList()
{
if (func_num_args() == 0) {
return false;
}
else {
$count = 0;
for ($i = 0; $i < func_num_args(); $i++) {
$count += func_get_arg($i);
}
return $count;
}
}

echo countList(1, 5, 9); // saída: "15"

26. Parâmetros Variáveis
•O resultado de qualquer dessas funções não pode ser
usado diretamente como um parâmetro para outra
função
–Podemos atribuir o valor a uma variável e então utilizá-lo
•Não funciona:
foo(func_num_args());
•Funciona:
$count = func_num_args();
foo($count);

27. Parâmetros Faltando
•Quando chamamos uma função, podemos passar
qualquer número de argumentos
•Qualquer parâmetro que a função espera que não tiver
sido passado permanece sem valor, e uma advertência é
gerada para cada um deles

28. Parâmetros Faltando
•Quando chamamos uma função, podemos passar
qualquer número de argumentos
•Qualquer parâmetro que a função espera que não tiver
sido passado permanece sem valor, e uma advertência é
gerada para cada um deles
function takesTwo($a, $b)
{
if (isset($a)) {
echo " a is set\n";
}
if (isset($b)) {
echo " b is set\n";
}
}

echo "With two arguments:\n";
takesTwo(1, 2);

echo "With one argument:\n";
takesTwo(1);

29. Parâmetros Faltando
•Quando chamamos uma função, podemos passar
qualquer número de argumentos
•Qualquer parâmetro que a função espera que não tiver
sido passado permanece sem valor, e uma advertência é
gerada para cada um deles
function takesTwo($a, $b)
{
if (isset($a)) {
echo " a is set\n";
}
if (isset($b)) {
echo " b is set\n";
}
}

echo "With two arguments:\n";
takesTwo(1, 2);

echo "With one argument:\n";
takesTwo(1);

With two arguments:
a is set
b is set
With one argument:
Warning: Missing argument 2 for takes_two()
in /path/to/script.php on line 6
a is set

30. Definição de Tipo
•Quando definimos uma função, podemos necessitar que
um parâmetro seja uma instância de uma classe em
particular, uma instância de uma classe que implementa
uma interface em particular, um array ou um callable
•Para atribuir definição de tipo em um parâmetro
devemos incluir o nome da classe, array ou callable
antes do nome da variável na lista de parâmetros da
função
•Uma definição de tipo não pode ser usada para requerer
um tipo escalar em particular (como inteiro ou string)

31. Definição de Tipo
•Quando definimos uma função, podemos necessitar que
um parâmetro seja uma instância de uma classe em
particular, uma instância de uma classe que implementa
uma interface em particular, um array ou um callable
•Para atribuir definição de tipo em um parâmetro
devemos incluir o nome da classe, array ou callable
antes do nome da variável na lista de parâmetros da
função
•Uma definição de tipo não pode ser usada para requerer
um tipo escalar em particular (como inteiro ou string)
class Entertainment {}

class Clown extends Entertainment {}

class Job {}

function handleEntertainment(Entertainment $a,
callable $callback = NULL)
{
echo "Handling " . get_class($a) . " fun\n";
if ($callback !== NULL) {
$callback();
}
}

$callback = function()
{
// faça alguma coisa
};

handleEntertainment(new Clown); // funciona
handleEntertainment(new Job, $callback); // erro

32. FUNÇÕES
Retornando Valores

33. Retornando Valores
•Funções em PHP podem retornar apenas um único valor
através da palavra-chave return
function returnOne()
{
return 42;
}
•Para retornar múltiplos valores podemos utilizar um array
function returnTwo()
{
return array("Fred", 35);
}
•Se nenhum valor é fornecido pela função, ela retornará
NULL

34. Retornando Valores por Referência
•Por definição, valores são copiados fora da função
•Para retornar um valor por referência, devemos declarar
a função com um & antes do nome e atribuir o valor
retornado a uma variável
$names = array("Fred", "Barney", "Wilma", "Betty");

function &findOne($n) {
global $names;
return $names[$n];
}
$person =& findOne(1); // Barney
$person = "Barnetta"; // modifica $names[1]

35. Retornando Valores por Referência
•Esta técnica é algumas vezes utilizada para retornar
grandes strings ou arrays de forma eficiente
•Entretanto, como PHP implementa copy-on-write para
valores de variáveis, retornar um valor de uma função
por referência é tipicamente desnecessário
•Retornar uma referência a um valor é mais lento que
retornar o valor em si

36. FUNÇÕES
Variáveis com Nomes de Funções

37. Variáveis com Nomes de Funções
•Da mesma maneira que uma variável pode conter o
nome de outra variável, acessado através do construtor
$$, podemos adicionar parênteses após uma variável
para chamar a função cujo nome é o valor armazenado
por ela, por exemplo, $variável()
•Para saber quando o valor uma variável representa uma
função, podemos utilizar a função function_exists(),
que pode ser utilizada para prevenir erros

38. Variáveis com Nomes de Funções
•Da mesma maneira que uma variável pode conter o
nome de outra variável, acessado através do construtor
$$, podemos adicionar parênteses após uma variável
para chamar a função cujo nome é o valor armazenado
por ela, por exemplo, $variável()
•Para saber quando o valor uma variável representa uma
função, podemos utilizar a função function_exists(),
que pode ser utilizada para prevenir erros
switch ($which) {
case 'first':
first();
break;
case 'second':
second();
break;
case 'third':
third();
break;
}

39. Variáveis com Nomes de Funções
•Da mesma maneira que uma variável pode conter o
nome de outra variável, acessado através do construtor
$$, podemos adicionar parênteses após uma variável
para chamar a função cujo nome é o valor armazenado
por ela, por exemplo, $variável()
•Para saber quando o valor uma variável representa uma
função, podemos utilizar a função function_exists(),
que pode ser utilizada para prevenir erros
switch ($which) {
case 'first':
first();
break;
case 'second':
second();
break;
case 'third':
third();
break;
}
if (function_exists($which)) {
$which();
// se $which é "first",
// a função first() será chamada, ...
}

40. Variáveis com Nomes de Funções
•Construtores da linguagem, como echo() e isset(),
não podem ser chamados através de variáveis com
nomes de funções:
$which = "echo";
$which("hello, world"); // não funciona

41. FUNÇÕES
Funções Anônimas

42. Funções Anônimas
•Algumas funções PHP utilizam uma função fornecida a
elas para realizar parte do seu trabalho
•Por exemplo, a função usort() utiliza uma função
passada a ela como parâmetro para determinar a forma
de ordenação dos itens em um array
•Podemos criar uma função anônima usando a sintaxe
normal de definição de uma função, mas a atribuindo a
uma variável ou a passando diretamente

43. Funções Anônimas
•Algumas funções PHP utilizam uma função fornecida a
elas para realizar parte do seu trabalho
•Por exemplo, a função usort() utiliza uma função
passada a ela como parâmetro para determinar a forma
de ordenação dos itens em um array
•Podemos criar uma função anônima usando a sintaxe
normal de definição de uma função, mas a atribuindo a
uma variável ou a passando diretamente
$array = array("really long string here, boy" ,
"this", "middling length", "larger");

// usort usa a função anônima para colocar o array
// em ordem de tamanho da string
usort($array, function($a, $b) {
return strlen($a) - strlen($b);
});

print_r($array);

44. Funções Anônimas
•Funções anônimas podem usar as variáveis definidas em seu
escopo através da sintaxe use
•Por exemplo:
$array = array("really long string here, boy" ,
"this", "middling length", "larger");
$sortOption = 'random';

usort($array, function($a, $b) use ($sortOption)
{
if ($sortOption == 'random') {
// sorteio aleatório retornando (−1, 0, 1)
return rand(0, 2) - 1;
}
else {
return strlen($a) - strlen($b);
}
});
print_r($array);

45. Curso de PHP – Funções
Fábio M. Pereira
UNIVERSIDADE ESTADUAL DO SUDOESTE
DA BAHIA – UESB
UNIDADE ORGANIZACIONAL DE
INFORMÁTICA - UINFOR

46. Baseado em...