PHPascal.com

PHPAscal rouge2 (Version bleu)


Programmation web CSS HTML PHP Jquery Javascript Wordpresse RSS SQL SSH, serveur linux Outils
  PHPascal a 144 articles


Recherche


cheap nike nfl jerseysWholesale cheap nfl jerseyscheap jerseys online from chinacheap nfl jerseys free shippingwholesale nba jerseysWholesale cheap nhl jerseyscheap nhl jerseys onlinecheap nba basketball jerseys

Valid HTML 5

Programmation web / PHP / Commentaire PHP

Commentaire PHP - Commentaires PHP

Voici comment mettre des commentaires PHP dans son code pour ensuite être capable de créé une documentation avec PHPDocumentor :

Pour toutes les pages, il faut ajouter les informations suivantes au début du fichier php :

/*
*  ici mettre les commentaires PHP sur le fichier en question à quoi il sert
*  commentaire php sur plusieurs lignes au besoin
*
* date modifier : 13 mars 2013
* @since 13 mars 2013
* @author Prénom Nom (courriel)
* @copyright PHPascal.com
* @version 1.2
*
*/




Pour une fonction on doit spécifier les paramêtres et les paramêtre envoyer (s'il y en a)
Exemple :

/*
* Fonction afficher sert à .. (description)
* @param $aaa =  description du paramètre 1
* @param $bbb=  description du paramètre 2
* @param $ccc=  description du paramètre 3 avec paramètre par defaut
* @return $rrr = description de la valeur retourné
*/
function afficher($aaa,$bbb,$ccc=0)
{
    .........................................
    ........................................
    return $rrr;
}





En utilisant ce type de formatage pour construire un site web dynamique en php, ont peux par la suite faire la création d'un documentation de sont site automatiquement avec PHPDocumentor.


Il y a aussi d'autres informations qu'on peux ajouter: voir la liste complète des tags PHPDocumentor.

Dans un script idéal il devrais y avoir en moyenne une ligne de commentaire pour chaque ligne de code.  Une ligne de code complexe mérite plusieurs lignes de commentaires PHP d'explication.  Par contre une boucle simple de nésésite aucun commentaire PHP. 

L'utilisation de variable textuel concrète nous permet d'avoir moins besoin d'utilisé de commentaire tout en ayant un code simple a comprendre. Par exemple $compteur_item pour utilisé un compteur du nombre d'item au lieu de metre $nb ou encore pire $x, $a, $zzz. 

 

Article écrit le 20 fvrier 2008
Article modifié le 8 octobre 2014

Autres articles sous la même catégorie


Pascal Dubreuil | © PHPascal.com 2017
Temps d'exécution : 0.0124 sec
Imprimer le 16 August 2017 - 23:47:50
par Pascal Dubreuil organisateur du Marathon de Laval