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.