Як уже зазначалося, PhpStorm використовуватиме звичайні блоки phpdoc:
Однак, починаючи з 2.1, він також підтримує анотації Netbeans / Eclipse / Zend @var :
Зверніть увагу, коментар починається з, /*
а не /**
(таким чином, він не відображатиметься, якщо ви створюєте фактичну документацію за допомогою phpdoc). Також аргументи міняються місцями, хоча PhpStorm приймає будь-яке замовлення:
І останнє, але не менш важливе: вони можуть передувати майже будь-якому довільному рядку коду (технічно, блоки phpdoc обмежені певними елементами).
Редагувати: станом на 2019 рік від анотацій Netbeans / Eclipse / Zend @var, здається, в основному відмовляються. NetBeans 11 їх більше не підтримує, і в цілому вони не підтримуються іншими середовищами розробки. Я пропоную використовувати інший синтаксис.