shawncplus/phpcomplete.vim — pull request #26 by FlickerBean (2013-08-01 15:30:54+00:00)
Title: Gives /* @var $myvar MyClass */ priority

Reasoning:
I'm sure there are many reasons people will want to override what phpcomplete believes to be right every now and then.
E.g I often use Factories to get instances of different child classes. eg

$newcar = MyFactory::getInstance(MyFactory::Car);

Unfortunately phpcomplete reads this wrong and gives me MyFactory completions.
I should be able to override this with /* @var $newcar Car */ and i'd like this placed above the creation of the $newcar variable, as others use different IDE's and this is where it's supposed to be placed. Unfortunately phpcomplete finds $mycar = MyFactory::getInstance before it finds my override.

This simply scans the file for overrides ( /* @var $newcar Car */ ) before it scans for everything else.

I would never go to the trouble of using a phpdoc override if I didn't want it abided by :)