88

Is there a way to hint WebIDE that a variable has some type? I have to iterate an array of objects, and there's no auto-completion available. This helps in ZendStudio:

/* @var ClassName $object */

I know there's a feature in JetBrains to declare an array of objects:

/**
 * @return ClassName[]
 */

But this works only with function's return type.

1
  • It works with arrays. Does it work with ArrayIterators which iterate over a specific type? Commented Sep 21, 2016 at 11:27

2 Answers 2

165

/* @var ClassName $object */ is a non-valid PHPDOC comment and is not parsed in the current version of Web IDE. Use double asterisks to make it work:

/** @var ClassName $object */

Also, you can annotate $array in foreach($array as $var) with /** @var ClassName[] $array */ and $var type will be deduced automatically.

4
  • didn't know about the square brackets notation
    – sanya
    Commented Aug 18, 2014 at 16:56
  • 2
    Related question: My PHP class uses magic getter for a variable and I want to bind that getter variable to a Class object, any idea how to do that? As I cannot define the variable in my class. Commented Nov 14, 2014 at 12:50
  • Wow.. just googled for fun and really no hope that this will actually be a thing.. I never was so wrong in my life and I am happy that I was wrong! This feature is so cool, thanks! :) Commented Feb 5, 2016 at 14:03
  • Very relevant for $this->getUser() inside a controller in a Symfony app Commented May 12, 2022 at 8:55
35

As already pointed out, PhpStorm will use regular phpdoc blocks:

/** @var ClassName $object */

However, since 2.1 it also supports Netbeans/Eclipse/Zend @var annotations:

/* @var $object ClassName */

Please note the comment starts with /* rather than /** (thus it won't show up if you generate actual documentation with phpdoc). Also, the arguments are swapped, though PhpStorm accepts any order:

/* @var ClassName $object */

Last but not least, they can precede almost any arbitrary line of code (technically, phpdoc blocks are restricted to certain items).


Edit: as of 2019, Netbeans/Eclipse/Zend @var annotations seem to be mostly abandoned. NetBeans 11 no longer supports them and in general they aren't supported by other IDEs. I suggest to use the other syntax.

2

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.