PHPDoc

PHPDoc est une transposition de Javadoc au langage PHP. Il s'agit d'un standard formalisé pour commenter le code PHP. Il permet d'utiliser des outils tels que phpDocumentor ou Doxygen pour générer la documentation du code, notamment les méthodes publiques, les API, etc. Il permet aussi à certains IDE (Zend Studio (en), NetBeans, etc.) de connaître le type des variables et de lever d'autres ambiguïtés dues au typage faible, améliorant ainsi la complétion de code, le "typage objet"[1] et le débogage.

PHPDoc

Informations
Type Générateur de documentation
Site web www.phpdoc.de

En , le PHP Framework Interoperability Group (PHP-FIG) commence à travailler sur le PSR-5, dérivé du standard de facto de phpDocumentor, pour développer et formaliser le standard PHPDoc[2].

Exemple

Les mots-clés PHPDoc commencent par une arobase[3]. Par exemple @return indique les types possibles de la valeur retournée par une méthode :

 /**
  * @return string|null The file path or null when non-existent.
  */
 function getPath()
 {
     ...
     return $path;
 }

Références
  1. Documentation PHP FR : Typage objet
  2. PSR-5: PHPDoc (Draft)
  3. Site officiel
  • Portail de la programmation informatique
Cet article est issu de Wikipedia. Le texte est sous licence Creative Commons - Attribution - Partage dans les Mêmes. Des conditions supplémentaires peuvent s'appliquer aux fichiers multimédias.