Еще в ноябре 2005 года на встрече в Париже разработчики обсудили новые возможности следующей, шестой, версии PHP. Интересует ли Вас, какой будет эта версия? Примите участие в опросе, который проводится на сайте рассылки.
[опрос на английском языке: PHP 6: Are you interesting in? (PHP 6: Вы зантересованы?) - YES (ДА) - NO (НЕТ)]
Комментарии
Аннотация
Поддерживаемые в PHP виды комментариев.
Комментарии необходимы для придания коду большей ясности. Они предназначаются для человека, а не для компьютера, поэтому при исполнении скрипта комментарии попросту игнорируются. Не передаются они, естественно, и в броузер.
Однострочные комментарии в стиле 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
*/
Пример 1. Различные виды комментариев
<?php
// This is an one-line C++ style comment
# This is an one-line Perl style commnent
/*
This is a multi-line
C style comment
*/
/**
* This is an example
* of inline documentation
*/
?>