Увод у коментаре на ПХП-у

Сама реч коментар изражава своје значење као коментарисање нечега. Ако коментаришемо било шта у програмској датотеци ПХП-а, оно се неће саставити са кодом. Компајлер или тумач ће ово једноставно игнорисати. Постоје разни начини на који можемо коментарисати било шта у програмском језику ПХП. ПХП такође има опцију за коментаре са једном и више линија. Такође, у коментару са једним редом можемо да користимо / или # према нашим погодностима. У коментару увек треба да напишемо одговарајући језик, тако да свако ко преиспитује тај код може да прочита и разуме коментар.

Синтакса

Опет, можемо да користимо коментар на горе поменуте начине у ПХП-у.

Коментар са једном линијом:

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

Како функционишу коментари у ПХП-у?

Оног тренутка када напишемо коментар у код, он ће бити лакши у односу на упоредни са стварним кодом. Ако смо написали код и коментар у истој датотеци, у овом случају коментар се неће извршити током извођења те ПХП датотеке. Па да видимо исто са примером.

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

Ово ће дати само „Ово је мој први ПХП програм“ као излаз, а не део коментара.

Зашто бисмо требали користити коментаре?

Требали бисмо употријебити коментар између ПХП програмског кода како бисмо били сигурни да имамо довољно коментара за помоћ како бисмо га могли лако прочитати и разумјети. Као коментар, такође можемо у сврху писања сегмента кода, промене датума, датума измене, модификованог и сл. Препоручује се програмеру да тај коментар користи у програмском коду тако да ствари могу да се разумеју лако, са мало или без икаквог напора кад год је то потребно.

Примери

Сада је време да се види брзи пример провере понашања коментара у програму.

Пример # 1

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

Излаз

Пример бр. 2

Коментар једне линије у програму

Шифра:

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

Излаз

Пример бр. 3

Вишеструки коментар у програму

Шифра:

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

Излаз

Сви коментари написани пре било које функције о тој функцији уобичајено су познати као документација о функцији. Дакле, у датим сценаријима можемо овај коментар рећи као функцијски документ. Стварно је лепо користити такав коментар. Да бисмо ПХП програм учинили робуснијим, имамо разне ПХП стандарде који кажу да не бисмо требали користити коментар унутар функције, јер можемо то учинити у документацији о функцијама.

Пример бр. 4

Мешовити коментар

У програмској датотеци ПХП-а, можемо комбиновати и ПХП и ХТМЛ. С обзиром на то, користићемо методу ХТМЛ коментара да бисмо коментирали ХТМЛ део кад год је потребно, а коментари ПХП-а могу се користити за код који се односи на ПХП према пословним захтевима. Можемо користити било које коментаре ПХП-а и ХТМЛ коментаре у ПХП-ХТМЛ датотеци.

Шифра:


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

Излаз

Пример бр. 5

Коментар у једној линији користећи #

Можемо користити и једноредне коментаре користећи и #. Погледајмо пример кода за исти. Видимо да ова линија коментара није толико популарна. Врло мали број програмера користи такве коментаре. Ово се заиста препоручује док коментаришете функцијску документацију или документацију на нивоу датотеке.

Шифра:

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

Излаз

Закључак - Коментари у ПХП-у

Коментар је заиста позив времена у код. Коментар можемо да користимо у нашој ПХП програмској датотеци. Ово ће нам помоћи да шифру учинимо разумљивијом. Коментар бисмо требали користити прије покретања функције или класе јер већина програмских језика има свој стандардни кодни стандард. Обично се коментар пре било које функције или класе назива документацијом те функције или класе.

Препоручени чланци

Ово је водич за коментаре у ПХП-у. Овде смо расправљали о уводу, како то функционише, зашто би требало да користимо коментаре заједно са примерима и резултатима. Можете и да прођете кроз друге наше предложене чланке да бисте сазнали више -

  1. Питхон Кеивордс
  2. Принт Арраи у Јави
  3. Шта је КСПатх?
  4. Наслеђивање у ПХП-у

Категорија:

Развој софтвера