[phpdoc] Update PhpDoc

Update PhpDoc and refactor some code (no code changes).
Removing the empty lines is wrong. The phpdoc standard requires an empty line between the summary and the description