Fixed PHPdocs

As reported by PhpStorm. I let it add the @throw lines (183) automatically. The changes to the @param and @return lines (63) I went through manually to make sure they're correct, because those are in my experience the only ones where auto-correction can mess it up a little.

I also did not change any actual code, so it's safe from that POV. Changed lines use spaces for indentation, so the diffs make it look like more than it really is.