PHP: Documentar funções

[levysantiago]

Inserir na documentação de cada função:

• Descrição da função.
• Descrição dos parâmetros de entrada
• Descrição dos tipos de retorno
• Exemplo de uso

Exemplo no javascript:

/**
* @description Faz a soma de dois números.
* @param {number} a - O primeiro número da operação.
* @param {number} b - O segundo número da operação.
* @returns {int} result - O resultado da soma de dois números.
* @example
* const result = sum(10, 2);
*/
function sum(a, b) {
  return a + b;
}