Comentaris en PHP
Comentaris en PHP

 

Perquè en futures revisions al teu codi per la teva part i sobretot per part d'altres programadors aquest codi sigui fàcil d'entendre, és bon costum complementar amb comentaris el codi PHP.

Taula de contingut

 

 

 

Els comentaris en PHP

Els comentaris que suporta PHP són els de C, C ++ i els del shell de Unix, podem usar // i /* */ per a comentaris i comentaris multilínia respectivament com faríem en C:

000 <? Php 
001 echo  'Aquesta línia s'executa' ;
002 // Aquesta línia no s'executa 
003 fet   'aquesta si s'executa' ; 
004 /* aquestes no s'executen */  
005 ?>


O també podem usar # com en els comentaris del shell de Unix:

000 <? Php
001 # això no s'executa
002 fet  'però això si' ;
003 ?>


Tindrem cura de no posar un comentari multi a l'interior de l'altre:

000 <? Php
001 /* /* No fer mai això */ */ 
002 ?>


Com veieu, PHP interpreta com a comentari des del primer /* al primer * / sense tenir en compte que hi ha un altre */, això ens produirà un error així que caldrà anar amb compte.

 

 

 

2 Quan comentar que no

És important que la quantitat de comentaris sigui proporcionada i que s'esculli adequadament en quin lloc posar un comentari o no posar-lo. Durant el curs, farem servir exemples amb més comentaris dels generalment recomanables per ajudar a la lectura als que els falti familiaritzar-se amb el llenguatge. Però quan programem les nostres aplicacions haurem de pensar a fer el codi comprensible a un programador d'un nivell mitjà. En general només escriurem comentaris per:

- Explicar el funcionament d'una funció abans de declarar-la 
- Explicar parts difícils d'entendre del nostre codi