funções

Um erro comum quando declarar uma função é a de escrever o seguinte:

function f ($opcional = “null”, $requerido)
{

}

Isto não vai provocar alerta de erros, mas também não faz qualquer sentido, porque você nunca será capaz de omitir o primeiro parâmetro ($opcional) se você deseja especificar o segundo, e você não pode omitir o segundo, porque o PHP irá emitir um aviso.

Neste caso, o que você realmente quer é comprimento variável da lista de argumentos, ou seja, a capacidade de criar uma função que aceita um número variável de argumentos, dependendo sobre a circunstância. Um exemplo típico deste comportamento é exibido pela família de funções printf().

PHP fornece três funções internas para lidar com comprimento variável da lista de argumentos:
func_num_args(), func_get_arg() e func_get_args(). Aqui está um exemplo de como elas são utilizadas:

function ola()
{
if (func_num_args() > 0) {
$arg = func_get_arg(0); // O primeiro argumento é a posição 0
echo “Olá $arg”;
} else {
echo “Olá Mundo”;
}
}
ola(“Leitor”); // Exibe “Olá Leitor”
ola(); // Exibe “Olá Mundo”

Você pode usar o comprimento variável da lista de argumentos mesmo se você especificar argumentos no cabeçalho da função. No entanto, isso não irá afetar a forma como o comprimento variável da lista de argumentos irá se comportar, por exemplo, func_num_args() ainda retornará o número total de argumentos passados para a função, ambos declarados e anônimos.

function contarTodos($arg1)
{
if (func_num_args() == 0) {
die(“Você precisa especificar pelo menos um argumento.”);
} else {
$args = func_get_args(); // Retorna um array de argumentos
array_shift($args); // Remove o argumento definido no inicio.
$count = strlen ($arg1);
foreach ($args as $arg) {
$count += strlen($arg);
}
}
return $count;
}
echo contarTodos(“um”, “dois”, “três”); // Exibe ’10’

Observação importante:
É muito importante ter em mente que o comprimento variável da lista de argumentos estão cheios de potenciais armadilhas, enquanto eles são muito poderosos, eles tendem a tornar o código confuso, porque é quase impossível de se prever casos de teste global se uma função que aceita um número variável de parâmetros não é construído adequadamente.

Todas as funções em PHP retornam valores, mesmo se você não informar o retorno. O conceito de função “vazia” não se aplica no PHP. Você pode especificar o valor de retorno da sua função usando a palavra-chave return.

function ola()
{
return “Olá mundo”; // Retorna uma string “Olá mundo”
}
$txt = ola(); // Atribui o valor de retorno “Olá mundo” para a variável $txt
echo ola(); // exibe “Olá mundo”

A palavra-chave return, também permite que você interrompa a execução de uma função, mesmo se você não quiser devolver um valor:

function ola($quem)
{
echo “Olá $quem”;
if ($quem == “mundo”) {
return; // Nada mais na função será processado
}
echo “, como vai você”;
}
ola(“mundo”); // exibe “Olá mundo”
ola(“leitor”) // Displays “Olá leitor, como vai você?”

Note, no entanto, que mesmo se você não retornar um valor, PHP ainda irá retornar da  sua função um valor NULL.
Funções também podem ser declaradas para que elas retornem por referência, o que permite a você o retorno de uma variável como o resultado da função, em vez de uma cópia (uma cópia está retornando o padrão para cada tipo de dados exceto objetos).
Normalmente, isto é usado para coisas como recursos (como conexões de dados) e quando se aplica o padrão de fábrica. No entanto, há uma ressalva: você deve retornar uma variável, você não pode retornar uma expressão por referência, ou utilizar uma declaração vazia para forçar um retorno de valor NULL:

function &query($sql)
{
$result = mysql_query($sql);
return $result;
}
// A função seguir é errada e vai o PHP irá emitir um aviso de erro quando chamado.

function &getHello()
{
return “Olá mundo”;
}

// Isto também irá fazer com que o alerta seja emitido quando chamado.
function &teste()
{
echo ‘Este é um teste’;
}