Added PHP Doc comments 

Added structured comments for PHP Doc. All comment additions, no logical changes.

See http://www.phpdoc.org/docs/latest/index.html for more details.