Как мне сгенерировать блоки документов для комментариев в файл php?
Среда IDE Netbeans автоматически генерирует их при вводе "/ **", и если вы используете Komodo, вы можете использовать следующий макрос
http://community.activestate.com/forum/phpdoc-autocompletion
В конце концов вы полагаетесь на IDE, которую используете для его поддержки.