[phpdoc] Update PhpDoc

Update PhpDoc and refactor some code (no code changes).
not needed. It is already documented at the interface level