My editor of choice for development has always been Vim. When I’m coding, I always leave PHPDOC comments for all classes, properties, and methods. I have been using a macro to include the basic PHPDOC comment header. This has worked fine for me so far. However, today I stumbled upon PHPDOC.vim plug-in. The plugin automatically creates the PHPDOC comment for you the second it sees you creating a class, method, or adding a class property.

To install just download the plugin from the following link:
http://markus.fischer.name/vim/phpdoc/phpdoc.vim

Place the file in your plug in directory for vim.
This can be found at ~/.vim/plugin

Once the plug in is installed, just open a PHP document and start creating a class, method, or property.