În afară de a furniza nume descriptive fişierelor care conţin scripturile dumnea­voastră PHP, trebuie să includeţi în fiecare script atât comentarii care să permită unui cititor să determine cu uşurinţă utilitatea scriptului, cât şi alte informaţii referi­toare la script. De exemplu, puteţi include un comentariu care precizează numele fişierului care conţine scriptul, astfel încât acesta să apară în versiunile tipărite ale scriptului.

Iată un model sintactic pentru comentariile PHP:

// Scrieţi aici comentariul dumneavoastra

După cum se poate vedea, un comentariu începe cu două caractere slash, urmate de un spaţiu. În continuare, linia conţine comentariul dumneavoastră, care poate include orice caractere doriţi, inclusiv caractere speciale.

Iată un exemplu simplu de script PHP care include comentarii:

<?php

// script-exemplu.php

// Acest script afiseaza un mesaj vizibil pentru utilizator.

Echo(„Acesta este un script foarte simplu.”);

?>

O modalitate de a crea un comentariu PHP pe mai multe linii este de a începe fiecare linie cu ajutorul caracterelor //. Totuşi, puteţi crea un comentariu din mai multe linii şi în alte moduri, dacă preferaţi. Iată un exemplu:

/*

Acesta este un comentariu pe mai multe linii. Poate fi alcătuit dintr-un număr oricât de mare de linii.

*/

Pentru a începe un comentariu alcătuit din mai multe linii, scrieţi caracterele /*, iar pentru a încheia comentariul, scrieţi caracterele */. Intre cele două perechi de caractere, puteţi scrie orice text doriţi, folosind oricâte linii doriţi.