quelqu'un peut-il expliquer ou donner des exemples comment utiliser la balise @Category dans le bon sens? PHPDocumentator n'analyse pas le tag.PHP comment utiliser la balise @Category dans DocBlocks
À quoi ressemble un File-DocBlock et un Class-DocBlock corrects?
Je ne sais pas si cela aide, mais ... De l'manual:
La balise @Category est utilisé pour organiser groupes de paquets ensemble. Ceci est directement applicable au convertisseur XML: DocBook/peardoc2, et peut être utilisé par d'autres convertisseurs. Autres Convertisseurs empaquetés avec phpDocumentor ignorer la catégorie, mais cela peut changer dans les versions futures. Il est également possible de spécifier dynamiquement la catégorie en utilisant le commutateur de ligne de commande -dc, --defaultcategoryname.
/**
* Page-Level DocBlock
* @package MyPackage
* @category mycategory
*/
/**
* @global array used for stuff
*/
function mine()
{
global $baz;
...
}
De plus, voici un sample of the proper way to write PEAR code, y compris docblocks avec @Category.
Veuillez publier un exemple de code qui n'est pas analysé, ce qui peut vous aider à répondre aux problèmes.
Je n'ai pas trouvé d'exemples utiles sur l'utilisation de la balise @category. Il m'a fait logique de l'utiliser pour représenter les couches MVC en utilisant cette balise-à-dire:
/**
* Layout or template
*
* @category view
*/
/**
* Database representation of the user
*
* @category model
*/
/**
* Login actions
*
* @category controller
*/
Voilà comment je l'utilise.