A apresentação está carregando. Por favor, espere

A apresentação está carregando. Por favor, espere

PHPdoc Aula PHPdoc Prof. Naércio Filho Técnico em Informática www.funpar.ufpr.br:8080/naercio.

Apresentações semelhantes


Apresentação em tema: "PHPdoc Aula PHPdoc Prof. Naércio Filho Técnico em Informática www.funpar.ufpr.br:8080/naercio."— Transcrição da apresentação:

1 PHPdoc Aula PHPdoc Prof. Naércio Filho Técnico em Informática

2 PHPdoc O Código do PHPdoc deve ser delimitado por /**...*/ como nos comentários normais porem com um * a mais Se uma linha dentro do bloco não começar com * então será ignorada na interpretação do PHPdoc Bloco de PHPdoc /** * */

3 PHPdoc Para documentar uma função, constante, classe e etc. O bloco deve ser colocado na linha imediatamente anterior a declaração /** * Esta é a doc de uma função */ function teste(){ // função } deste modo podemos documentar: define() constantes, functions, classes, métodos das classes, variáveis das classes, include() e variáveis globais

4 PHPdoc - Descrição Curtas – são delimitadas por uma linha em branco, ou um ponto final. Longas – é todo o conteúdo de uma descrição /** * Descrição curta * * Descrição completa junto com a anterior, continuando daqui até o fim. * * A linha em branco informa uma quebra de parágrafo */

5 PHPdoc Algumas Tags derivadas do HTML podem ser usadas para formatar a documentação, funcionando como no HTML –,,,,,,, outras são especificas: – -- Usada para destacar o código em PHP – -- Destaca um trecho de Exemplo – -- Destaca um nome de Variável

6 PHPdoc se uma linha começar com um desses caracteres o PHPdoc pode interpreta-los como uma lista "-", "+", "#", "o" ou um numero seguido de (.) e um espaço em branco, neste ultimo caso cada linha deverá ficar uma abaixo da outra /** * bloco com listas * * +não é uma lista, não tem espaço em branco * Listas * - item 1 * - item 2, linha um * multi linha *- item 3 */

7 PHPdoc – Templates se houver uma seqüência de dados redundantes podemos usar Templates todas as informações desde o inicio * */ até o termino

8 PHPdoc – Templates receberão a mesma PHPdoc private string */ var $_var1 = 'Ola'; var $_var2 = 'PHP'; var $_var3 = 'doc';

9 PHPdoc – Templates retornando algo assim: /** private string */ var $_var1 = Ola'; /** private string */ var $_var2 = PHP'; /** private string */ var $_var3 = doc';

10 PHPdoc - Classe / Metodo Tipo de Acesso, Nome do Informações de Informa quando um método nao é aconselhavel o Caminho para um arquivo contendo um Compatibilidade com o JavaDoc

11 PHPdoc - descrição das variáveis globais /tipo $globalvar Variável Global / tipo Descrição da Ignorar o Documenta Funções Descrição dos parâmetros /tipo [$var] Valor de Retorno / tipo descrição

12 PHPdoc - Link para algum endereço / Apelido para a Documento o Pacote do Script / package Nome de um outro elemento documentado (cria um link para Uma data ou numero de Compatibilidade com o Define o Tipo da variável / Numero de versão

13 PHPdoc Após o projeto documentado podemos gerar relatórios usando o PHPdoc na linha de comando Na linha de comando um modo seria – phpdoc -t /path/to/output -d path/to/directory1,/another/path,/third/path\ -f /path/to/anotherfile.php -i *test.php,tests/ -pp on -ti My Title -o HTML:frames:phpedit onde phpdoc é o aplicativo instalado pode ser encontrado em: e os outros dados são parâmetros para a geração, locais de output, onde procurar os arquivos a documentar, titulo, e parâmetros de HTML


Carregar ppt "PHPdoc Aula PHPdoc Prof. Naércio Filho Técnico em Informática www.funpar.ufpr.br:8080/naercio."

Apresentações semelhantes


Anúncios Google