Fixed a lot of phpdoc issues

Added / Fixed a lot of phpdoc issues
- added missing throws annotations
- added missing return annotations
- fixed a lot of param annotations

This is just the first part of fixing the phpdocs - so it covers not all issues yet, but it has a deep impact to help contributing more features. Let me know if i should rebase my fork or something else to have this contribution merged.