Uvod u komentare na PHP-u
Sama riječ komentar izražava svoje značenje kao komentiranje iz nečega. Ako komentiramo bilo što u programskoj datoteci PHP-a, ono se neće sastaviti s kodom. Sastavljač ili tumač će to jednostavno ignorirati. Postoje razni načini na koji možemo komentirati bilo što u programskom jeziku PHP. PHP također ima jedno-linijske i višestruke opcije komentara. Također, u komentaru s jednim retkom možemo koristiti / ili # prema našim pogodnostima. U komentaru uvijek trebamo napisati odgovarajući jezik kako bi svatko tko pregledava taj kôd mogao pročitati i razumjeti taj komentar.
Sintaksa
Opet, možemo koristiti komentar na dolje spomenute načine u PHP-u.
Komentar s jednim retkom:
// 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
Kako djeluju komentari u PHP-u?
Onog trenutka kada u kôd napišemo komentar, bit će lakši u odnosu na stvarni kod. Ako smo u istu datoteku napisali kôd i komentar, u ovom slučaju komentar se neće izvršiti tijekom izvođenja te PHP datoteke. Pa da vidimo isto s primjerom.
echo "This is my first PHP Program";
// this is the first program
?>
Ovo će dati samo 'Ovo je moj prvi PHP program' kao izlaz, a ne dio komentara.
Zašto bismo trebali koristiti komentare?
Trebali bismo upotrijebiti komentar između PHP programskog koda kako bismo bili sigurni da imamo dovoljno komentara za pomoć kako bismo lako mogli pročitati i razumjeti kôd. Kao komentar možemo i u svrhu pisanja segmenta koda, promjene datuma, datuma izmjene, modificiranog itd. Programeru se preporučuje korištenje komentara u programskom kodu kako bi se stvari razumjele lako s malo ili nikakvog napora kad god je to potrebno.
Primjeri
Sada je vrijeme da se vidi brzi primjer provjere ponašanja komentara u programu.
Primjer 1
<_?phpecho "This is my first PHP Program";
// this is the first program
?>
Izlaz
Primjer 2
Komentar jednog retka u programu
Kodirati:
<_?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
?>
Izlaz
Primjer 3
Komentar s više linija u programu
Kodirati:
<_?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);
?>
Izlaz
Svi komentari napisani prije bilo koje funkcije o toj funkciji uobičajeno su poznati kao dokumentacija o funkciji. Dakle, u danim scenarijima možemo ovaj komentar reći kao funkcijski dokument. Stvarno je lijepo koristiti takav komentar. Da bismo PHP program učinili robusnijim imamo razne PHP standarde koji kažu da ne bismo trebali koristiti komentar unutar funkcije, jer možemo to učiniti u dokumentaciji o funkcijama.
Primjer 4
Mješoviti komentar
U programskoj datoteci PHP-a, možemo kombinirati PHP i HTML. S obzirom na to, koristit ćemo HTML način komentiranja kako bismo komentirali HTML dio kad god je to potrebno, a komentari PHP-a mogu se koristiti za kôd koji se odnosi na PHP prema poslovnim zahtjevima. U PHP-HTML datoteci možemo koristiti bilo kakve komentare PHP-a i HTML komentare.
Kodirati:
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
?>
Izlaz
Primjer 5
Komentar s jednom linijom pomoću #
Komentiranje u jednom retku možemo koristiti i pomoću #. Pogledajmo primjer koda za isti. Vidimo da ova linija komentiranja nije toliko popularna. Vrlo malo programera koristi takve komentare. Ovo se stvarno preporučuje dok komentirate funkcijsku dokumentaciju ili dokumentaciju na razini datoteke.
Kodirati:
<_?php# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>
Izlaz
Zaključak - Komentari u PHP-u
Komentar je zaista poziv vremena u kod. Komentar možemo upotrijebiti u našoj PHP programskoj datoteci. To će nam pomoći da kod učinimo razumljivijim. Trebali bismo upotrijebiti komentar prije pokretanja funkcije ili klase jer većina programskih jezika ima svoj standard koda. Obično se komentar prije bilo koje funkcije ili klase naziva dokumentacijom te funkcije ili klase.
Preporučeni članci
Ovo je vodič za komentare na PHP-u. Ovdje smo raspravljali o uvodu, kako se to radi, zašto trebamo koristiti komentare zajedno s primjerima i rezultatima. Možete i proći kroz naše druge predložene članke da biste saznali više -
- Python Ključne riječi
- Ispis matrice u Javi
- Što je XPath?
- Nasljeđivanje u PHP-u