Improved phpdoc_params fixer

See https://github.com/FriendsOfPHP/PHP-CS-Fixer/issues/838.

I've also added 2 failing tests to demonstrate other issues with this fixer.
the variable name is misleading