REFACTOR: Make php code sniffer happy.

Close all ERRORS except file and function documentationa.
Also took care of some WARNINGS but left most of them, they are stupid
for requiring the alignment of equals signs.
DOCUMENTATION: Adding function documentation.

For great justice but also to make PHP code sniffer happy, complete
PHPDoc function blocks are added.
DOCUMENTATION: Updated the README.