[phpdoc] Update PhpDoc

Update PhpDoc and refactor some code (no code changes).
This does not add any value. the signature already gives the same information