Add complete PHPDocs

Access to accurate types makes the code easier to work with.

Btw, are you set on still supporting PHP 5? Making the jump to 7 would allow us to use native types and improved tooling.