Fix some inspections warnings reported by PhpStorm

This pull requests aims at fixing some PHPDocs and code smells detected by PhpStorm's built-in inspection tool.
The pull request is done on top of #192.

I've commented below every change made to executable line of code, everything else being PHPDocs. There remains a few auto-completion issues, mostly caused by type hints on incomplete interfaces (see also #191).