Uvod v komentarje v PHP
Beseda komentar izrazi svoj pomen kot komentiranje iz nečesa. Če v programski datoteki PHP komentiramo karkoli, ne bo sestavljeno s kodo. Prevajalnik ali tolmač to preprosto prezre. S programskim jezikom PHP lahko komentiramo karkoli v programskem jeziku PHP. PHP ima tudi možnost za komentiranje v eni in več vrsticah. Tudi v komentarju z eno vrstico lahko uporabimo / ali #, kot je to primerno. V komentar bi morali vedno zapisati ustrezen jezik, da lahko vsak, ki pregleduje to kodo, prebere in razume ta komentar.
Sintaksa
Spet lahko komentar uporabimo na spodnje načine v PHP-ju.
Komentar v eni vrstici:
// 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 delujejo komentarji v PHP?
V trenutku, ko v kodo napišemo komentar, bo v primerjavi z dejansko kodo lažji. Če smo v isti datoteki zapisali kodo in komentar, v tem primeru komentar med izvajanjem te datoteke PHP ne bo izveden. Torej poglejmo enako s primerom.
echo "This is my first PHP Program";
// this is the first program
?>
To bo samo "To je moj prvi program PHP" kot izhod, ne pa komentar.
Zakaj bi morali uporabljati komentarje?
Komentar med programsko kodo PHP bi morali uporabiti za zagotovitev dovolj pripomb za pomoč, da bomo lahko preprosto prebrali in razumeli kodo. V komentarju lahko tudi napišemo segment kode, spremenimo datum, datum spremembe, spremenimo itd. Razvijalcem zelo priporočamo, da komentar uporabi v programski kodi, tako da lahko stvari razumejo enostavno, z malo ali nič truda, kadarkoli je to potrebno.
Primeri
Zdaj je čas, da si ogledamo hiter primer preverjanja obnašanja komentarja v programu.
Primer # 1
<_?phpecho "This is my first PHP Program";
// this is the first program
?>
Izhod
Primer # 2
Komentar v enojni vrstici v programu
Koda:
<_?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
?>
Izhod
Primer # 3
Komentar v več vrsticah
Koda:
<_?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);
?>
Izhod
Vsi komentarji, napisani pred katero koli funkcijo o tej funkciji, so splošno znani kot dokumentacija o funkcijah. Torej lahko v danih scenarijih ta komentar rečemo kot funkcijski dokument. To je res lepo uporabiti tak komentar. Za bolj trden program PHP imamo različne standarde PHP, ki pravijo, da ne smemo uporabljati komentarjev znotraj funkcije, saj lahko to storimo v dokumentaciji funkcije.
Primer št. 4
Mešani komentar
V programski datoteki PHP lahko kombiniramo PHP in HTML. Glede na to bomo uporabili način komentiranja HTML, da bomo komentirali del HTML, kadar je to potrebno, pripombe PHP pa lahko uporabimo za kodo, povezano s PHP, glede na poslovne zahteve. V datoteki PHP-HTML lahko uporabljamo kakršne koli komentarje PHP in komentarje HTML.
Koda:
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
?>
Izhod
Primer št. 5
Komentar v eni vrstici z #
Eno vrstico lahko komentiramo tudi s pomočjo #. Poglejmo primer kode za isto. Vidimo, da ta vrstica komentarjev ni tako priljubljena. Zelo malo razvijalcev uporablja tovrstne komentarje. To je res priporočljivo, medtem ko komentirate funkcijsko dokumentacijo ali dokumentacijo na ravni datoteke.
Koda:
<_?php# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>
Izhod
Zaključek - komentarji v PHP
Komentar je res klic časa v kodi. Komentar lahko uporabimo v naši programski datoteki PHP. To nam bo pomagalo narediti kodo bolj razumljivo. Komentar bi morali uporabiti pred začetkom funkcije ali razreda, saj ima večina programskih jezikov svoj standard kode. Običajno je komentar pred katero koli funkcijo ali razredom poklical dokumentacijo te funkcije ali razreda.
Priporočeni članki
To je vodnik za komentarje v PHP. Tukaj razpravljamo o uvodu, kako deluje, zakaj bi morali uporabljati komentarje skupaj s primeri in izidi. Obiščite lahko tudi druge naše predlagane članke, če želite izvedeti več -
- Ključne besede Python-a
- Natisni matriko v Javi
- Kaj je XPath?
- Dedovanje v PHP