updated php-docs

some @throws-annotations were missing
there should be an empty comment line between 2 different types of PHPdoc annotations