Как уже отмечалось, PhpStorm будет использовать обычные блоки phpdoc:
Однако, начиная с версии 2.1, он также поддерживает аннотации Netbeans / Eclipse / Zend @var :
Обратите внимание на комментарий начинается , с /*
чем /**
( при этом он не будет отображаться , если вы создаете реальную документацию с PHPDoc). Кроме того, аргументы меняются местами, хотя PhpStorm принимает любой порядок:
И последнее, но не менее важное: они могут предшествовать практически любой произвольной строке кода (технически блоки phpdoc ограничены определенными элементами).
Изменить: по состоянию на 2019 год аннотации Netbeans / Eclipse / Zend @var, похоже, в основном заброшены. NetBeans 11 больше не поддерживает их, и, как правило, они не поддерживаются другими IDE. Предлагаю использовать другой синтаксис.