Header docblocks for PHPDoc

Addresses part of #1130.

This pull request adds header docblocks to all PHP files, and begins to address some of the other PHPDoc warnings.

http://jenkins.buttonweavers.com:8080/job/buttonmen-blackshadowshade/344/