updated PHP Doc Block

Update some PHP Doc Block for better IDE completetion
This library uses the lowercase `null`, as required by [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md#25-keywords-and-truefalsenull)