Нет необходимости комментировать тип констант, так как тип всегда:
- скаляр или массив
- известно во время объявления
- неизменное
@const
также не является частью стандарта PHPDoc. PHP-FIG предлагает @var
, но это не поддерживается PHPDoc и не добавляет никакой информации, которую вы уже не можете извлечь из самого объявления.
Поэтому для удобства чтения я рекомендую использовать простой докблок PHPDoc для документирования ваших констант:
class Foo
{
/** This is a constant */
const BAR = 'bar';
}
Он будет описывать константу, когда вы генерируете PHPDocs, но сохраняете комментарии чистыми и читаемыми.