[phpdoc] Update PhpDoc

Update PhpDoc and refactor some code (no code changes).
Saying it's an interface neither