PHPDoc является аналогом Javadoc адаптированным для использования в среде php. Он поддерживает как объектно-ориентированный. так и процедурный код.
В среде NetBeans присутствует интегрированная поддержка PHPDoc. Поэтому комментирование кода представляет следующие приемущества:
1. Повышение скорости разработки.
2. Повышение качества сопровождения.
3. Подсветка синтаксиса.
4. Автодополнение процедур и функций.
5. Автодополнение полей и методов классов.
6. Отладка.