« Programmation PHP/Premier programme » : différence entre les versions

Contenu supprimé Contenu ajouté
Shawn (discussion | contributions)
Aucun résumé des modifications
Ligne 92 :
=Standardisation des commentaires=
Les commentaires sont très utiles aux programmeurs, mais se révèlent surtout indispensables lors de travail en équipe. Il existe en outre des logiciels qui génèrent une documentation complète à partir des commentaires insérés dans le code du programme. De là est apparue une certaine forme de standardisation de ceux-ci afin de faciliter la génération de documentation. Vous trouverez des exemples de codes commentés sur cette page de [http://pear.php.net/manual/en/standards.sample.php PEAR].
 
Les commentaires en PHP peuvent se trouver sous deux formes : la première sert pour un commentaire tenant sur une seule ligne. Il faut placer deux slashes en début de ligne. Exemple :
<pre>
<?php
// Voici mon premier commentaire
?>
</pre>
 
Avec cette méthode, si l'on veut inserer plusieurs lignes de commentaires, il faut placer les doubles slashes en début de '''chaque''' ligne. On peut aussi utiliser la deuxième méthode qui consiste à commencer un bloc de commentaire par <code>/*</code> et le terminer par <code>*/</code> quelle que soit sa longueur. Exemple :
<pre>
<?php
/* Voici un bloc
de commentaires
pouvant contenir plusieurs lignes */
?>
</pre>
 
=Liens externes=