Updating PhpDoc headers in almost all files, documenting untested code in README.md
Updating PhpDoc for several file headers.

Signed-off-by: Euan Torano <euantorano@gmail.com>