Add PhpdocVarAnnotationCorrectOrderFixer

[kubawerlos]

Closes #2159

[dmvdbrugge]

2 things:

1. This needs to ensure priority before PhpdocVarWithoutNameFixer.
2. This should also fix @type

[dmvdbrugge]

What is the reasoning behind not fixing @param?

[kubawerlos]

@dmvdbrugge the alternative for 2 is not a acceptable as we cannot assume some will use PhpdocNoAliasTagFixer.

@param is not fixed as the idea is to fix @var cases - I've never seen @param with variable name before type and @param more often has description than @var.

I'm not sure now, maybe we can aim to have PhpdocCorrectOrderOfTypeAndNameFixer to handle all Phpdoc types that have type and name the same, yet I prefer to add mixed when type is missing instead of getting first word of string behind the name as it can do more harm like:

 /**
- * @param $foo This is foo
+ * @param This $foo us foo
  */

[dmvdbrugge]

the alternative for 2 is not a acceptable as we cannot assume some will use PhpdocNoAliasTagFixer.

Was thinking that as well, removed the suggestion.

As for the @param, makes sense. So only those 2 points for me.

[kubawerlos]

@dmvdbrugge @type added, yet I cannot find valid case for priority integration test with PhpdocVarWithoutNameFixer - it handles well name with both orders:

 <?php
 /**
- * @var FooInterface $foo
+ * @var FooInterface
  */
 $foo;
 
 /**
- * @var $bar BarInterface
+ * @var BarInterface
  */
 $bar;

[dmvdbrugge]

So nice that it immediately adds value to the project itself 🎉

[keradus]

Thank you @kubawerlos.

[SpacePossum]

thanks @kubawerlos , very nice to have this one! : D

[phansys]

Thank you @kubawerlos! 🎉