Отправляет email-рассылки с помощью сервиса Sendsay

PHP 5 для начинающих

  Все выпуски  

БАЗОВЫЙ СИНТАКСИС: Комментарии


PHP 5 для начинающих

Вниманию читателей!

Отдельные выпуски рассылки в той или иной мере взаимосвязаны. С предыдущими выпусками Вы можете ознакомиться:

  1. в архиве рассылки (оригиналы выпусков);
  2. на сайте рассылки (исправленные и дополненные версии).

# # #

Вы также можете подписаться на рассылку "PHP 5: Новые возможности".

PHP 6 уже в разработке!

Еще в ноябре 2005 года на встрече в Париже разработчики обсудили новые возможности следующей, шестой, версии PHP. Интересует ли Вас, какой будет эта версия? Примите участие в опросе, который проводится на сайте рассылки.

http://pterodactyl.l2p.net/e107/

[опрос на английском языке: PHP 6: Are you interesting in? (PHP 6: Вы зантересованы?) - YES (ДА) - NO (НЕТ)]

Аннотация

Поддерживаемые в PHP виды комментариев.

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

PHP поддерживает несколько видов комментариев (Пример 1, «Различные виды комментариев»).

Однострочные комментарии в стиле C++. Они открываются двойным слэшем (//) и действуют до конца строки. Могут начинаться с середины строки. Закрывающая часть как таковая отсутствует. Эти комментарии удобны для кратких пометок по поводу кода в текущей строке.

ini_set('safe_mode', '1'); // turn safe mode on

Замечание

Если еще до конца строки встретится закрывающая часть PHP тэга, то действие однострочного комментария также заканчивается.

<p>*** <?php // comment ?> ***</p>
*** ***

Однострочные комментарии в стиле Perl. Ничем не отличаются от комментариев в стиле C++, кроме открывающего символа (#). Такой стиль принят также в командной оболочке Unix-подобных операционных систем.

# End Of Script

Замечание

Однострочные комментарии несколько нарушают положение о равноправности любых последовательностей пробельных символов. Действительно, если символ(ы) новой строки в конце такого комментария заменить на обычный пробел или табуляцию, то действие комментария распространится и на тот код, который ранее образовывал следующую, незакомментированную строку. Поэтому правильнее было бы говорить о равноправии любых последовательностей пробельных символов после удаления из кода всех (однострочных) комментариев.

Многострочные комментарии в стиле C. В отличие от однострочных, многострочные комментарии отграничиваются с обеих сторон. Открывающая часть состоит из двух символов: слэша и звездочки (/*); закрывающая - из тех же символов, но в обратном порядке (*/).

/*
    Demo Script
    Version 0.00
*/
        

Внимание

При использовании многострочных комментариев необходимо следить за тем, чтобы они не оказались вложенными друг в друга, так как это может привести к непредсказуемым результатам. Например, в следующем случае - /* 1 /* 2 */ 3 */ - действительно закомментированными окажутся только части 1 и 2.

Встроенная документация. Разновидность многострочного комментария, отличающаяся дополнительной звездочкой в открывающей части (/**). Используется для написания встроенной в скрипт документации, которая впоследствии может автоматически распознаваться и обрабатываться внешними приложениями. Хотя это и не влияет на распознавание данного вида комментария, принято каждую новую строку в комментарии начинать со звездочки (при этом используется своеобразное выравнивание).

/**
 * Inline Documentation
 */
        

Created with DocBook Created with Libxslt


В избранное