Как правильно комментировать код в PHP?

В PHP есть два способа комментировать код: www.internet-technologies.ru

1. Однострочные комментарии. www.internet-technologies.ru Перед ними ставятся два символа косой черты (//). www.internet-technologies.ru Однострочный комментарий может находиться на отдельной строке или добавляться в конец строки кода. www.internet-technologies.ru Пример: <?php // Это однострочный комментарий ?>. www.internet-technologies.ru
2. Многострочные комментарии. www.internet-technologies.ru Они обернуты разделителями /* и /. www.internet-technologies.ru Знак / обозначает начало блока комментариев, а */ указывает на его конец. www.internet-technologies.ru Многострочные комментарии полезны, когда заметки, которые нужно вставить в код, занимают более одной строки. www.internet-technologies.ru

Также в PHP есть поддержка C-подобных многострочных комментариев (DocComment). stfalcon.com Докблок отличается дополнительной звёздочкой /** в начале комментария. stfalcon.com