PHPDoc comments and Logger interface

Hi Brian,

Here are the PHPDoc code completion amendments, as promised. Christmas preparations held me up a bit, but better late than never ;) I also added a simple logger interface in a separate commit, for people implementing a custom logger.

Cheers,
Alex