How to declare the type for local variables using PHPDoc notation?

Question

I use Zend Studio to develop in PHP with CakePHP, and one of the problems with CakePHP is that the views all reference undeclared local variables.

So for example, in the controller you would

$this->set('job',new MyJobObject());

Then in the view you could

echo $job->getName();

My problem is that Zend Studio can't perform autocomplete on $job, because it's type is unknown. Now there are PHPDoc tags that allow you to declare the type so that IDE's can perform autocomplete. The @var tag for example can be used in a class to define a property's type.

class MyJobObject
{
    /**
     * @var MyStatusObject
     */
    public $status;
}

Is there a way to do something like this for local variables?

Levente Pánczél · Accepted Answer · 2014-08-12T19:16:49.040

48

You have to use the one-line form: /** @var $job MyJobObject */

Note that some editors prefer the syntax the other way around: /** @var MyJobObject $job */

edited Aug 12 '14 at 19:16

answered Jan 22 '13 at 15:49

Levente Pánczél

1,895
2
14
16

1

You can put this anywhere in an executable block and it will be effective until the end of the function (or any re-definition). – Levente Pánczél Jan 22 '13 at 15:52
5

NetBeans seems to recognize `/* @var $varName varType */` syntax ( **note** there's just one `*` at the begining of comment) – matt Sep 04 '14 at 21:33

Daniel W. · Answer 2 · 2020-01-22T20:45:41.397

Both answers are wrong^*, strictly speaking:

/** @var MyJobObject $job */

Is correct - the type is always the first argument, then you put a description or specify the variable itselfs.

Resources:

https://scrutinizer-ci.com/docs/tools/php/php-analyzer/guides/annotating_code https://docs.phpdoc.org/latest/references/phpdoc/types.html

Otherweise, every modern PHP IDE is able to recognize almost any kind of comment syntax:

// @var
/* @var */
/** @var */
/* @var
*/
# @var

The most common, most readable and most widely accepted form is

/** @var <type> [variable [comment]] */


/** 
 * @var <type> [variable [comment]] 
 */

PSR-5 (Proposed) https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc.md

PSR-19 (Draft) https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md

_{*) In 2013 the syntax might have been different.}

This should be the accepted answer and also the only one supported by PHP CS fixer. — mvorisek, Jun 04 '20 at 07:21
Agreed, immediately after entering in `/**` in PHPStorm above a variable it automatically goes to this syntax as well — sMyles, May 21 '21 at 21:58

score 2 · Answer 3 · answered Jan 22 '13 at 15:50

2

You shoud do on top of your view / template file.

<?PHP
/* @var $job MyJobObject */
?>

answered Jan 22 '13 at 15:50

GreenRover

1,486
1
14
33

This is no longer the correct syntax. You now need an additional astrik in the comments punctuation as shown here `/** @var */` – JΛYDΞV Aug 04 '21 at 07:14

How to declare the type for local variables using PHPDoc notation?

3 Answers3

Linked