Commenter son code source en PHP

Dans mon entourage, et plus précisément en dehors du milieu professionnel,  la plupart des développeurs pensent que commenter son code est une perte de temps. Pour eux, il suffit simplement de le lire pour le comprendre. Cependant, ce sont ces commentaires qui qualifient la qualité et la maintenabilité d’un code. Dans cet article, je vais vous expliquer ce que permettent ces commentaires et comment les mettre en place.

Définition d’un commentaire

Un commentaire est une ligne de code non exécutée par l’interpréteur. Il peut s’écrire sur une ou plusieurs lignes.

<?php
//Ceci est un commentaire sur une ligne

/* Ceci est
*  un commentaire
*  sur plusieurs lignes
*/
?>

Continue reading