Cum și de ce să comentezi în Codul tău PHP

Un comentariu în cod PHP este o linie care nu este citită ca parte a programului. Singurul său scop este să fie citit de cineva care editează codul. Deci, de ce folosiți comentarii?

  • Să-i anunți pe ceilalți ce faci. Dacă lucrați cu un grup de oameni sau planificați pe oricine altcineva folosind scriptul dvs., comentariile spuneți celorlalți programatori ce faceți la fiecare pas. Acest lucru face mult mai ușor pentru ei să lucreze și să modifice codul dvs., dacă este nevoie.
  • Pentru a-ți reaminti ce ai făcut. Deși este posibil să scrieți un script rapid pentru dvs. și nu vedeți nevoia de comentarii, mergeți mai departe și adăugați-le în orice caz. Majoritatea programatorilor s-au confruntat cu revenirea pentru a-și edita propria lucrare un an sau doi mai târziu și trebuie să își dea seama ce au făcut. Comentariile îți pot aminti gândurile tale când ai scris codul.

Există mai multe moduri de a adăuga un comentariu în cod PHP. Primul este prin utilizarea // pentru a comenta o linie. Acest stil de comentarii de o singură linie comentează doar sfârșitul liniei sau blocul de cod curent, după cum vine primul. Iată un exemplu:

 

 ecou „salut”; 

 // acesta este un comentariu 

 ecou „acolo”; 

 ?> 

Dacă aveți un singur comentariu de linie, o altă opțiune este să folosiți un semn #. Iată un exemplu al acestei metode:

 

ecou „salut”;
# acesta este un comentariu
ecou „acolo”;
?>

Dacă aveți un comentariu mai lung, cu mai multe linii, cel mai bun mod de a comenta este cu / * și * / înainte și după un comentariu îndelungat. Puteți conține mai multe rânduri de comentarii în interiorul unui bloc. Iată un exemplu:

 

 ecou „salut”; 

 / * 

 Folosind această metodă 

 puteți crea un bloc de text mai mare 

 și totul va fi comentat 

 * / 

 ecou „acolo”; 

 ?> 

Nu amestecați comentariile

Deși puteți cuibări comentariile în comentarii în PHP, faceți acest lucru cu atenție. Nu toate cuibăresc la fel de bine. PHP acceptă comentariile în stil C, C ++ și în stilul Unix. Comentariile în stil C se termină la primul * / se întâlnesc, deci nu cuibărește comentariile în stil C. 

Dacă lucrați cu PHP și HTML, fiți conștienți că comentariile HTML nu înseamnă nimic pentru analizorul PHP. Acestea nu vor funcționa așa cum intenționează și sunt susceptibile de a executa unele funcții. Deci, stați departe de: