Add comments php: PHP: Comments — Manual

PHP Комментарии

❮ Предыдущий Далее ❯


Комментарий в PHP-коде — это строка, которая не выполняется как часть программа. Его единственная цель — быть прочитанным кем-то, кто смотрит на код.

Комментарии можно использовать для:

  • Пусть другие понимают ваш код
  • Напомните себе о том, что вы сделали. Большинство программистов возвращались к своей работе через год или два, и им приходилось переосмысливать то, что они сделали. Комментарии могут напомнить вам, о чем вы думали, когда писали код

PHP поддерживает несколько способов комментирования:

Пример

Синтаксис однострочных комментариев:



// Это однострочный комментарий

# Это тоже однострочный комментарий
?>


< /html>

Попробуйте сами »

Пример

Синтаксис для многострочных комментариев:



/*
Это многострочный блок комментариев
, занимающий несколько
строк
*/
?>


Попробуйте сами »

Пример

Использование комментариев для пропуска частей кода:



// Вы также можете использовать комментарии, чтобы опустить часть строки кода
$x = 5 /* + 15 */ + 5;
эхо $x;
?>


Попробуйте сами »

❮ Предыдущая Следующий ❯


ВЫБОР ЦВЕТА



Лучшие учебники
Учебник по HTML
Учебник по CSS
Учебник по JavaScript
Учебник How To
Учебник по SQL
Учебник по Python
Учебник по W3. CSS
Учебник по Bootstrap
Учебник по PHP
Учебник по Java
Учебник по C++
Учебник по jQuery

Лучшие ссылки
HTML Reference
CSS Reference
JavaScript Reference
SQL Reference
Python Reference
W3.CSS Reference
Bootstrap Reference
PHP Reference
HTML Colors
Java Reference
Angular Reference
jQuery Reference


8 Top0 Examples Примеры HTML
Примеры CSS
Примеры JavaScript
Примеры инструкций
Примеры SQL
Примеры Python
Примеры W3.CSS
Примеры Bootstrap
Примеры PHP
Примеры Java
Примеры XML
Примеры jQuery


FORUM | О

W3Schools оптимизирован для обучения и обучения. Примеры могут быть упрощены для улучшения чтения и обучения. Учебники, ссылки и примеры постоянно пересматриваются, чтобы избежать ошибок, но мы не можем гарантировать полную правильность всего содержания.

Используя W3Schools, вы соглашаетесь прочитать и принять наши условия использования, куки-файлы и политика конфиденциальности.

Авторское право 1999-2022 по данным Refsnes. Все права защищены.
W3Schools использует W3.CSS.

Комментарии PHP

Резюме : в этом руководстве вы узнаете, как использовать комментарии PHP для документирования кода.

Комментарии являются важной частью кода. Комментарии предоставляют полезную информацию, которая позже поможет вам и другим разработчикам быстрее понять смысл кода.

PHP поддерживает два типа комментариев:

  • Однострочные комментарии
  • Многострочные комментарии

Однострочные комментарии

Однострочные комментарии размещаются в конце строки или в текущем блоке.

Однострочный комментарий начинается с фунта ( # ) или двойной косой черты ( // ). Остальной текст после (//) игнорируется интерпретатором PHP.

В следующем примере // используется для однострочного комментария:

 

Язык кода: HTML, XML (xml)

В следующем примере используется # для однострочного комментария:

 

Язык кода: HTML, XML (xml)

Многострочные комментарии

Многострочные комментарии начинаются с /*  и заканчиваются */ . Например:

 

Язык кода: HTML, XML (xml)

На практике вы используете многострочный комментарий, когда вам нужно разделить комментарии на несколько строк.

Написание осмысленных комментариев

Чтобы эффективно документировать свой код, используйте следующие рекомендации:

1) Чтобы код говорил сам за себя, не используя комментарии, называя осмысленные идентификаторы. Например, вы можете использовать следующее:

 

$is_completed = true;

Язык кода: PHP (php)

Вместо использования загадочного имени с комментарием:

 

$ic = true; // завершено

Язык кода: PHP (php)

Сам код может быть хорошим комментарием.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *