Вступ до коментарів на PHP
Слово коментар сам по собі виражає своє значення, як щось коментує. Якщо ми коментуємо що-небудь у програмному файлі PHP, воно не буде складено з кодом. Компілятор або перекладач це просто проігнорують. Існують різні способи, з якими можна коментувати що-небудь на мові програмування PHP. PHP також має однорядний та кілька рядкових варіантів коментарів. Крім того, в коментарях з одним рядком ми можемо використовувати / або # відповідно до нашої зручності. Ми завжди повинні писати відповідну мову в коментарі, щоб кожен, хто переглядає цей код, міг прочитати та зрозуміти цей коментар.
Синтаксис
Знову ж таки, ми можемо використовувати коментар нижчезазначеними способами в PHP.
Коментар на одній лінії:
// 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
Як працюють коментарі в PHP?
Щойно ми напишемо коментар у коді, він буде легшим у порівнянні з фактичним кодом. Якщо ми написали код і коментар в одному файлі, в цьому випадку коментар не буде виконуватися під час запуску цього PHP-файлу. Тож побачимо те саме на прикладі.
echo "This is my first PHP Program";
// this is the first program
?>
Це дасть лише "Це моя перша програма PHP" як вихід, а не частина коментарів.
Чому ми повинні використовувати коментарі?
Ми повинні використовувати коментар між кодом програми PHP, щоб переконатися, що у нас є достатньо коментарів довідки, щоб можна було легко читати та розуміти код. У коментарі ми також можемо написати сегмент коду, змінити дату, дату модифікації, змінити і т. Д. Настійно рекомендується розробникові використовувати коментар у коді програмування, щоб все можна було зрозуміти. легко, без особливих зусиль або зусиль, коли потрібно.
Приклади
Тепер прийшов час побачити короткий приклад перевірки поведінки коментаря в програмі.
Приклад №1
<_?phpecho "This is my first PHP Program";
// this is the first program
?>
Вихід
Приклад №2
Однорядковий коментар у програмі
Код:
<_?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
?>
Вихід
Приклад №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);
?>
Вихід
Будь-які коментарі, написані перед будь-якою функцією щодо цієї функції, зазвичай називають документацією щодо функцій. Отже, у наведених сценаріях цей коментар можна сказати як функціональний документ. Це дуже приємно використовувати такий коментар. Щоб зробити програму PHP більш надійною, у нас є різні стандарти PHP, які говорять, що не слід використовувати коментарі всередині функції, оскільки ми можемо робити те саме в документації щодо функцій.
Приклад №4
Змішаний коментар
У файлі програми PHP ми можемо поєднати і PHP, і HTML. Враховуючи це, ми будемо використовувати метод коментування HTML, щоб коментувати частину HTML, коли це потрібно, і коментарі PHP можна використовувати для коду, що стосується PHP, відповідно до бізнес-вимог. Ми можемо використовувати будь-які коментарі PHP та коментарі HTML у файлі PHP-HTML.
Код:
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
?>
Вихід
Приклад №5
Коментар в одній лінії за допомогою #
Ми можемо використовувати однорядковий коментар, використовуючи також #. Давайте подивимось приклад коду для того ж. Ми бачимо, що цей рядок коментування не так популярний. Дуже мало розробників використовують такі коментарі. Це дійсно рекомендується на той час коментувати функціональну документацію або документацію на рівні файлів.
Код:
<_?php# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>
Вихід
Висновок - коментарі в PHP
Коментар - це дійсно заклик часу в коді. Ми можемо використовувати коментар у нашому програмному файлі PHP. Це допоможе нам зробити код більш зрозумілим. Ми повинні використовувати коментар перед запуском функції або класу, оскільки більшість мов програмування мають свій стандарт коду. Зазвичай коментар перед будь-якою функцією або класом називається документацією цієї функції або класом.
Рекомендовані статті
Це посібник щодо коментарів у PHP. Тут ми обговорюємо вступ, як це працює, чому ми повинні використовувати коментарі разом із Прикладами та результатами. Ви також можете ознайомитися з іншими запропонованими нами статтями, щоб дізнатися більше -
- Ключові слова Python
- Друкувати масив на Java
- Що таке XPath?
- Спадщина в PHP