PHPDoc multiple @param types inside @method

Question

I use PHPDoc to enhance PhpStorm hinting. Normally, a method would have a PHPDoc like this:

/**
 * @param array|callable $a
 * @param int $b
 * @return mixed
 */
public function x($a, $b) {
    // …
}

I need to describe the same inside a @method tag. PhpStorm (or PHPDoc) doesn't like the vertical bar. If I take it out with one of the types – everything looks good.

/**
 * @method mixed x(array|callable $a, int $b)
 */
class A {
    // …
}

First, is this a legal syntax for @method tag and the problem is with PhpStorm? If not, is there a way to describe arguments in full inside @method? Thanks!

ndm · Accepted Answer · 2014-05-06 08:19:37Z

3

It's not yet supported, just like specifying arrays of types using the bracket syntax.

http://youtrack.jetbrains.com/issue/WI-22571

I'm not aware of any workaround for this, other than using mixed (which isn't really a workaround).

I'd suggest to comment and vote in the tracker.

answered May 6, 2014 at 8:19

ndm

60.6k9 gold badges73 silver badges113 bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

PHPDoc multiple @param types inside @method

1 Answer 1

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Related