Fix phpdoc

Fixes:
- Missing definitions of arguments
- Invalid typeint
- Missing definitions of exceptions thrown
- Missing definitions of returns
I would document it as ``@return \SplFileInfo[]`` to give more details