In programare, comentariile au un rol foarte bine determinat si foarte util, de altfel. Ele sunt folosite pentru explicarea codului scris. Utilitatea folosirii comentariilor se observa cel mai bine la dezvoltarea aplicatiilor mari. Fisiere care cu mii de linii de cod, care nu sunt comentate, sunt practic imposibil de citit si inteles ulterior. Iar daca am dori sa modificam un astfel de fisier misiunea noastra ar fi aproape imposibila.
In PHP comentariile pot fi de 2 tipurii:
- comentarii pe o singura linie ( folosite, in general, pentru o scurta detaliere a codului respectiv)
- comentarii pe mai multe linii ( se folosesc atunci cand este necesar prezentarea algoritmului folosit sau o detaliere pe larg a codului)
1) Comentarii pe o singura linie
Pentru a comenta o singura linie PHP foloseste 2 etichete: // sau #. Ele sunt inserate la inceputul liniei si tot ce urmeaza acestor etichete pana la finalul liniei vor fi interpretate ca fiind comentarii.
Exemplul urmator va ilustra folosirea acestor etichete:
<?
// setez valoarea primului numar
$numar1 = 1;# setez valoarea celui de al doilea numar
$numar2 = 2;print “Primul numar are valoarea $numar1, iar ce de al doilea are valoarea $numar2″;
?>
2) Comentarii pe mai multe linii
Pentru comentarii pe mai multe linii se pot folosi etichetele: /* si respectiv */. Prima va marca inceputul comentariului, iar cea de a doua va marca sfarsitul acestui comentariu.
Urmatorul exemplu va folosi comentarii pe mai multe linii:
<?
/*
Nume script: multiline_comment_example.php
Data: 08 Aprilie 2008
*/print “Acest exemplu contine un comentariu pe mai multe linii!”;
?>
Comentariul pe mai multe linii poate fi construit si folosind comentarii pentru o singura linie. In acest caz exemplu anterior ar arata:
<?
// Nume script: multi_comment_example.php
// Data: 08 Aprilie 2008print “Acest exemplu contine un comentariu pe mai multe linii!”;
?>