phpDoc tags and indentation changes

Hi, I added phpDoc to your great piece of code for auto-completion within IDE's. Can you please accept this pull request so that I can do a composer update and have auto-completion :)