Kommentaarid PHP-s - Kuidas kommentaarid toimivad PHP-s? - Näited

Sissejuhatus PHP kommentaaridesse

Sõna kommentaar ise väljendab oma tähendust kui midagi kommenteeriv. Kui kommenteerime mõnda PHP-programmi faili, ei koostata seda koodiga. Koostaja või tõlk jätab selle lihtsalt tähelepanuta. Midagi PHP-programmeerimiskeeles kommenteerimist saab teha mitmel viisil. PHP-l on ka üherealine ja mitmerealine kommentaarivalik. Samuti võime üherealises kommentaaris kasutada oma mugavuse huvides / või #. Peaksime alati kommentaari kirjutama sobiva keele, et kõik, kes seda koodi vaatavad, saaksid seda kommentaari lugeda ja sellest aru saada.

Süntaks

Jällegi võime kasutada kommentaari PHP-s allpool nimetatud viisidel.

Üherealine kommentaar:

// 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

Kuidas PHP-s kommentaarid toimivad?

Kui me kommentaari koodi kirjutame, on see tegeliku koodiga võrreldes suhteliselt kergem. Kui meil on kood ja kommentaar kirjutatud samasse faili, siis sel juhul seda PHP-faili käitamisel kommentaari ei teostata. Vaatame sama näitega.

echo "This is my first PHP Program";
// this is the first program
?>

See annab väljundina ainult 'See on minu esimene PHP programm', mitte kommentaari osa.

Miks me peaksime kommentaare kasutama?

Peaksime kasutama PHP-programmi koodi vahele jäävat kommentaari, et veenduda, kas meil on piisavalt abikommentaare, et koodi oleks hõlpsasti võimalik lugeda ja mõista. Kommentaarina võime ka koodi segmendi kirjutamiseks muuta kuupäeva, muutmiskuupäeva, muudetud jne. Arendajale on tungivalt soovitatav kasutada kommentaari programmeerimiskoodis, et asjadest aru saada hõlpsalt, vähese vaevaga või ilma vajaduseta.

Näited

Nüüd on aeg näha mõnda kiiret näidet, kuidas kontrollida kommentaari käitumist programmis.

Näide nr 1

<_?php
echo "This is my first PHP Program";
// this is the first program
?>

Väljund

Näide 2

Üherealine kommentaar programmis

Kood:

<_?php
echo 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
?>

Väljund

Näide 3

Mitmerealine kommentaar programmis

Kood:

<_?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);
?>

Väljund

Kommentaare, mis on selle funktsiooni kohta kirjutatud enne mis tahes funktsiooni, nimetatakse tavaliselt funktsiooni dokumentatsiooniks. Seega võime antud stsenaariumides öelda selle kommentaari funktsioonidokumendina. See on tõesti tore seda kommentaari kasutada. PHP-programmi jõulisemaks muutmiseks on meil mitmesuguseid PHP-standardeid, mis ütlevad, et me ei tohiks funktsiooni sees olevat kommentaari kasutada, kuna funktsiooni dokumentatsioonis saame teha sama.

Näide 4

Segakommentaar

PHP-programmifailis saame ühendada nii PHP kui ka HTML. Seda arvesse võttes kasutame vajadusel HTML-i kommenteerimiseks HTML-i kommenteerimismeetodit ja PHP-kommentaare saab kasutada ärinõuete kohaselt PHP-ga seotud koodi jaoks. PHP-HTML-failis võime kasutada mis tahes tüüpi PHP-kommentaare ja HTML-i kommentaare.

Kood:


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

PHP with HTML
echo "Hello World!"; // this is PHP comment
?>


Väljund

Näide 5

Üherealine kommentaar, kasutades #

Saame kasutada üherealist kommenteerimist, kasutades ka #. Vaatame sama koodi näidet. Me näeme, et see kommentaaride rida pole nii populaarne. Selliseid kommentaare kasutavad väga vähesed arendajad. See on tõesti soovitatav funktsiooni dokumentatsiooni või failitaseme dokumentatsiooni kommenteerimise ajal.

Kood:

<_?php
# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>

Väljund

Järeldus - kommentaarid PHP-s

Kommentaar on koodis tõesti ajaline kõne. Kommentaari saame kasutada meie PHP-programmi failis. See aitab meil koodi arusaadavamaks muuta. Enne funktsiooni või klassi käivitamist peaksime kasutama kommentaari, kuna enamikul programmeerimiskeeltel on oma koodistandard. Tavaliselt kutsus kommentaar enne mis tahes funktsiooni või klassi selle funktsiooni või klassi dokumenteerimist.

Soovitatavad artiklid

See on juhend kommentaaridesse PHP-s. Siin arutleme sissejuhatuse üle, kuidas see töötab, miks peaksime kasutama kommentaare koos näidete ja väljunditega. Lisateavet leiate ka meie muudest soovitatud artiklitest -

1. Pythoni märksõnad
2. Prindimassiivi Java
3. Mis on XPath?
4. Pärand PHP-s