Introducere în Comentarii în PHP
Însuși cuvântul comentariu își exprimă sensul ca comentând ceva. Dacă comentăm ceva din fișierul programului PHP, acesta nu va fi compilat cu codul. Compilatorul sau interpretul vor ignora pur și simplu acest lucru. Există diferite modalități prin care putem comenta orice lucru din limbajul de programare PHP. PHP are, de asemenea, o singură linie și mai multe opțiuni de comentarii pe linie. De asemenea, în comentariul cu o singură linie, putem utiliza / sau # în funcție de comoditatea noastră. Ar trebui să scriem întotdeauna limba adecvată în comentariu, astfel încât oricine examinează acest cod să citească și să înțeleagă acel comentariu.
Sintaxă
Din nou, putem folosi comentariul în modurile menționate mai jos în PHP.
Comentariu cu o singură linie:
// This is a single-line comment
# This is a single-line comment
/*
This is a multiple line comment – line no – 1
This is a multiple line comment – line no – 2
… and so on …
*/
# this is the single-line comment
; this is a PHP.INI style commenting
Cum funcționează Comentariile în PHP?
În momentul în care scriem comentariul în cod, va fi mai ușor din punct de vedere comparativ în comparație cu codul real. Dacă avem cod scris și comentariul în același fișier, în acest caz, comentariul nu va fi executat în timpul rulării acelui fișier PHP. Deci, să vedem la fel cu un exemplu.
echo "This is my first PHP Program";
// this is the first program
?>
Aceasta va oferi doar „Acesta este primul meu program PHP” ca rezultat, nu și partea de comentariu.
De ce ar trebui să folosim comentarii?
Ar trebui să folosim comentariul dintre codul programului PHP pentru a ne asigura că am avut suficiente comentarii de ajutor, astfel încât să poată citi și înțelege cu ușurință codul. În comentariu, putem, de asemenea, în scopul scrierii segmentului codului, schimbarea datei, data modificării, modificată de etc. Este foarte recomandat pentru un dezvoltator să folosească comentariul din codul de programare, astfel încât lucrurile să poată fi înțelese ușor cu puțin sau fără efort ori de câte ori este necesar.
Exemple
Acum, este timpul să vedeți câteva exemple rapide despre verificarea comportamentului comentariului în program.
Exemplul # 1
<_?phpecho "This is my first PHP Program";
// this is the first program
?>
producție
Exemplul # 2
Comentariu cu o singură linie în program
Cod:
<_?phpecho date_default_timezone_get(); //to get the timezone
echo "
"; //line brea;
date_default_timezone_set('Asia/Kolkata'); // setting the timezone to Asia/Kolkata
echo date_default_timezone_get(); //to get the timezone
?>
producție
Exemplul # 3
Comentariu cu mai multe linii în program
Cod:
<_?php/*
This is a function that will take time in minutes and will return that in hours and minutes
We use will this function further to test with some examples.
*/
function hoursandmins($minutes, $format = '%01d Hours, %02d Minutes')
(
if ($minutes < 1) (
return;
)else if($minutes<10)(
if($minutes==1)(
return '0'.$minutes.' Minute';
)
return '0'.$minutes.' Minutes';
)else if($minutes<50)(
return $minutes.' Minutes';
)
$hours = floor($minutes / 60);
$minutes = ($minutes % 60);
$format = "";
if($hours>0)(
if($hours>1)(
$format .= '%01d Hours';
)else(
$format .= '%01d Hour';
)
)
if($hours>0 && $minutes>0)(
$format .= ', ';
)
if($minutes>0)(
if($minutes>1)(
$format .= ' %02d Minutes';
)else(
$format .= ' %01d Minute';
)
)
return sprintf($format, $hours, $minutes);
)
// time to check the time in descriptive form
echo hoursandmins(20);
echo "
";
echo hoursandmins(120);
?>
producție
Orice comentarii scrise înainte de orice funcție despre acea funcție sunt cunoscute în mod obișnuit ca documentația funcției. Deci, în scenariile date putem spune acest comentariu ca un document funcțional. Este foarte drăguț să folosești comentariul așa. Pentru a face programul PHP mai robust, avem diverse standarde PHP care spun că nu ar trebui să folosim comentariul din interiorul funcției, deoarece putem face același lucru în documentația funcției.
Exemplul # 4
Comentariu mixt
Într-un fișier de program PHP, putem combina atât PHP cât și HTML. Având în vedere acest lucru, vom folosi metoda de comentare HTML pentru a comenta partea HTML ori de câte ori este necesar, iar comentariile PHP pot fi utilizate pentru codul aferent PHP, conform cerințelor de afaceri. Putem folosi orice fel de comentarii PHP și comentarii HTML într-un fișier PHP-HTML.
Cod:
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
producție
Exemplul # 5
Comentariu cu o singură linie folosind #
Putem folosi un singur rând care comentează folosind și #. Să vedem un exemplu de cod pentru același lucru. Putem vedea că această linie de comentare nu este atât de populară. Foarte puțini dezvoltatori folosesc aceste tipuri de comentarii. Acest lucru este într-adevăr recomandat pentru a comenta în timp ce documentația funcției sau documentația la nivel de fișier.
Cod:
<_?php# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>
producție
Concluzie - Comentarii în PHP
Un comentariu este într-adevăr un apel al timpului în cod. Putem folosi comentariul în fișierul nostru de programe PHP. Acest lucru ne va ajuta să facem mai inteligibil codul. Ar trebui să folosim comentariul înainte de a începe o funcție sau o clasă, deoarece majoritatea limbajelor de programare au propriul standard de cod. De obicei, comentariul înaintea oricărei funcții sau a clasei numea documentația acelei funcții sau a clasei.
Articole recomandate
Acesta este un ghid pentru Comentarii în PHP. Aici vom discuta introducerea, Cum funcționează, de ce ar trebui să folosim comentarii împreună cu exemple și rezultate. Puteți parcurge și alte articole sugerate pentru a afla mai multe -
- Cuvinte cheie Python
- Print Array în Java
- Ce este XPath?
- Moștenire în PHP