[CLEANUP] Use the Type[] array syntax in PhpDoc

This will help IDEs like PhpStorm with static code analysis and
code completion.

Also add missing blank lines between the @param and @return lines.

Closes #104
Merge pull request #121 from jjriv/cleanup/array-syntax

[CLEANUP] Use the Type[] array syntax in PhpDoc